游戏客户端架构 / 系统课时
计时器漂移怎么复现和定位
计时器漂移怎么复现和定位
计时器“越跑越慢”不一定是时钟不准:有时是每次触发都丢掉超出的零头,形成累计误差;有时只是低帧率让回调只能落在较晚的帧边界。暂停恢复还会引入另一种时钟语义。本节用确定性输入复现三种现象,并给出可直接看日志定性的定位方法。
学习目标
- 用高低帧交替与暂停场景稳定复现计时异常。
- 区分会持续增长的累计误差与只在单次触发出现的调度误差。
- 根据游戏时间、单调时间和实际业务语义选择正确的修复方式。
先把“漂移”拆成两类
累计误差通常来自错误的重置方式。假设周期为 1000 ms,某一帧让累计值从 960 ms 跨到 1080 ms;若触发后直接把累计值设为 0,就把超出的 80 ms 永久丢掉。每触发一次都可能再丢一段零头,于是触发时间越来越晚。
调度误差则不同。若计时器的目标截止点仍然是固定的 1000、2000、3000 ms,但回调只能在帧更新时执行,那么 1000 ms 的任务可能在 1080 ms 才被观察到。只要下一个截止点仍按原时间轴推进,这个 80 ms 不会自动累加到下一周期。
暂停恢复还要先选时钟:游戏时间通常可以随暂停停止;单调时间用于可靠计算真实经过时长,不应受系统校时回拨影响;日历时间适合展示时间戳,不适合直接做短周期计时。

可重复复现高低帧与暂停
下面脚本不依赖真实睡眠,而是直接喂入确定性的帧耗时:60 个 16 ms 帧后插入一个 120 ms 低帧,并重复四次。这样每次运行都能得到相同结果,也更容易区分算法问题和机器负载。
INTERVAL_MS = 1000
FRAME_TIMES_MS = ([16] * 60 + [120]) * 4
def reset_to_zero(frames):
now = 0
elapsed = 0
fires = []
for dt in frames:
now += dt
elapsed += dt
if elapsed >= INTERVAL_MS:
fires.append(now)
elapsed = 0 # 错误点:把跨过阈值的余量一起丢掉。
return fires
def preserve_remainder(frames):
now = 0
elapsed = 0
fires = []
for dt in frames:
now += dt
elapsed += dt
while elapsed >= INTERVAL_MS:
fires.append(now)
elapsed -= INTERVAL_MS
return fires
def fixed_deadline(frames):
now = 0
next_due = INTERVAL_MS
fires = []
for dt in frames:
now += dt
if now >= next_due:
fires.append((now, now - next_due))
# deadline 沿原时间轴推进;若跨过多个周期,这里选择跳过过期槽位。
while next_due <= now:
next_due += INTERVAL_MS
return fires
print("reset:", reset_to_zero(FRAME_TIMES_MS))
print("remainder:", preserve_remainder(FRAME_TIMES_MS))
print("deadline:", fixed_deadline(FRAME_TIMES_MS))
game_time = sum(FRAME_TIMES_MS)
pause_ms = 5000
monotonic_time = game_time + pause_ms
print(f"after pause: game={game_time}ms monotonic={monotonic_time}ms")
print(f"next game due in={5000 - game_time}ms")
print(f"real-time deadline overdue={monotonic_time - 5000}ms")预期输出
reset: [1080, 2160, 3240, 4320]
remainder: [1080, 2008, 3008, 4008]
deadline: [(1080, 80), (2008, 8), (3008, 8), (4008, 8)]
after pause: game=4320ms monotonic=9320ms
next game due in=680ms
real-time deadline overdue=4320msreset 的误差从 80 ms 增长到 320 ms,说明零头被反复丢弃;deadline 中后续迟到只有 8 ms,说明主要受帧边界限制。暂停后的两个结果则说明,同一个“5 秒计时器”若绑定不同时间源,恢复后的正确行为会完全不同。
看日志就能定性
每次触发至少记录 scheduledAt、firedAt、lateness、当前帧 dt、暂停状态和计时器使用的时钟。若 lateness 在低帧时增大、帧率恢复后又回落,且 scheduledAt 始终位于固定节拍上,问题属于调度抖动而非累计漂移。
若下一次目标时间是用“本次实际触发时间 + 周期”计算,或者累计器触发后直接清零,就要重点查累计误差。此时即使以后恢复高帧率,已经丢掉的余量也不会自己回来。
暂停后出现巨大的 lateness 也不一定是 bug。真实时间倒计时本来就应该继续前进;玩法冷却或关卡计时如果设计为暂停冻结,则应绑定游戏时间。先确认业务语义,再决定是否补触发、跳过过期周期或只执行一次。
修复策略与验收
周期任务若要求长期稳定节拍,优先使用“固定 deadline 递增”或“累计器减去周期并保留余量”,不要在触发后无条件清零。一次低帧可能让本次回调迟到,但不应改变下一次理论截止点。
对于错过多个周期的情况,还要明确补偿策略:可以逐次补跑、合并成一次并携带错过次数,或直接跳到下一个未来截止点。哪一种都可以,但必须与任务语义一致,不能让定时器框架自行猜测。
验收时重复执行高低帧切换、持续低帧和暂停 5 秒三个场景。累计型定时器应在多次触发后仍围绕固定节拍;调度误差应随帧率恢复而收敛;暂停后的行为必须与选定时钟语义一致。做到这三点,才能判断修复的是计时逻辑,而不是只让某次测试看起来正常。