游戏客户端架构 / 系统课时

计时器漂移怎么复现和定位

计时器漂移怎么复现和定位

计时器“越跑越慢”不一定是时钟不准:有时是每次触发都丢掉超出的零头,形成累计误差;有时只是低帧率让回调只能落在较晚的帧边界。暂停恢复还会引入另一种时钟语义。本节用确定性输入复现三种现象,并给出可直接看日志定性的定位方法。

学习目标

  • 用高低帧交替与暂停场景稳定复现计时异常。
  • 区分会持续增长的累计误差与只在单次触发出现的调度误差。
  • 根据游戏时间、单调时间和实际业务语义选择正确的修复方式。

先把“漂移”拆成两类

累计误差通常来自错误的重置方式。假设周期为 1000 ms,某一帧让累计值从 960 ms 跨到 1080 ms;若触发后直接把累计值设为 0,就把超出的 80 ms 永久丢掉。每触发一次都可能再丢一段零头,于是触发时间越来越晚。

调度误差则不同。若计时器的目标截止点仍然是固定的 1000、2000、3000 ms,但回调只能在帧更新时执行,那么 1000 ms 的任务可能在 1080 ms 才被观察到。只要下一个截止点仍按原时间轴推进,这个 80 ms 不会自动累加到下一周期。

暂停恢复还要先选时钟:游戏时间通常可以随暂停停止;单调时间用于可靠计算真实经过时长,不应受系统校时回拨影响;日历时间适合展示时间戳,不适合直接做短周期计时。

计时器累计误差与调度误差时间线

可重复复现高低帧与暂停

下面脚本不依赖真实睡眠,而是直接喂入确定性的帧耗时:60 个 16 ms 帧后插入一个 120 ms 低帧,并重复四次。这样每次运行都能得到相同结果,也更容易区分算法问题和机器负载。

python
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")

预期输出

text
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=4320ms

reset 的误差从 80 ms 增长到 320 ms,说明零头被反复丢弃;deadline 中后续迟到只有 8 ms,说明主要受帧边界限制。暂停后的两个结果则说明,同一个“5 秒计时器”若绑定不同时间源,恢复后的正确行为会完全不同。

看日志就能定性

每次触发至少记录 scheduledAt、firedAt、lateness、当前帧 dt、暂停状态和计时器使用的时钟。若 lateness 在低帧时增大、帧率恢复后又回落,且 scheduledAt 始终位于固定节拍上,问题属于调度抖动而非累计漂移。

若下一次目标时间是用“本次实际触发时间 + 周期”计算,或者累计器触发后直接清零,就要重点查累计误差。此时即使以后恢复高帧率,已经丢掉的余量也不会自己回来。

暂停后出现巨大的 lateness 也不一定是 bug。真实时间倒计时本来就应该继续前进;玩法冷却或关卡计时如果设计为暂停冻结,则应绑定游戏时间。先确认业务语义,再决定是否补触发、跳过过期周期或只执行一次。

修复策略与验收

周期任务若要求长期稳定节拍,优先使用“固定 deadline 递增”或“累计器减去周期并保留余量”,不要在触发后无条件清零。一次低帧可能让本次回调迟到,但不应改变下一次理论截止点。

对于错过多个周期的情况,还要明确补偿策略:可以逐次补跑、合并成一次并携带错过次数,或直接跳到下一个未来截止点。哪一种都可以,但必须与任务语义一致,不能让定时器框架自行猜测。

验收时重复执行高低帧切换、持续低帧和暂停 5 秒三个场景。累计型定时器应在多次触发后仍围绕固定节拍;调度误差应随帧率恢复而收敛;暂停后的行为必须与选定时钟语义一致。做到这三点,才能判断修复的是计时逻辑,而不是只让某次测试看起来正常。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

计时器漂移怎么复现和定位

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通