多人游戏与网络同步 / 系统课时
投射物消失不同步怎么查
投射物消失不同步怎么查
投射物在一端已经消失、另一端却继续飞行,通常不是单一“网络丢包”问题。排查时应沿着生成、网络更新、命中、销毁四个阶段逐段核对同一个 projectileId,直到找到两端状态首次分叉的位置。
学习目标
- 用统一实体 ID 重建投射物生命周期
- 区分生成、更新、命中和销毁阶段的不同步原因
- 通过最小日志定位客户端残留或提前消失
先判断是哪一个阶段分叉
先不要盯着画面猜原因,而是为每个投射物记录稳定的 projectileId,并给每个关键事件附上 serverTick 或权威时间。一次完整生命周期至少应能看到 spawn、update、hit、destroy 四类事件。
如果客户端没有 spawn,问题在生成或首次同步;如果有 spawn 但位置停止更新,问题在网络更新或客户端应用;如果一端已经 hit 而另一端没有,重点检查命中广播;如果服务端已经 destroy 而客户端仍显示,则重点检查销毁消息、实体查找和本地清理逻辑。
用同一个 ID 对齐日志
排查时不要只记录“发射了一个火球”这样的自然语言信息。日志至少应包含实体 ID、事件名、服务端 Tick 和当前生命周期状态,必要时再记录发送与接收序号。
例如下面的最小排查脚本可以从两份日志中找出某个投射物最后一个共同事件,并显示之后的分叉位置:
client_events = [
{"projectileId": "p-17", "event": "spawn", "tick": 100},
{"projectileId": "p-17", "event": "update", "tick": 101},
{"projectileId": "p-17", "event": "update", "tick": 102},
]
server_events = [
{"projectileId": "p-17", "event": "spawn", "tick": 100},
{"projectileId": "p-17", "event": "update", "tick": 101},
{"projectileId": "p-17", "event": "hit", "tick": 102},
{"projectileId": "p-17", "event": "destroy", "tick": 102},
]
client_keys = {(e["tick"], e["event"]) for e in client_events}
server_keys = {(e["tick"], e["event"]) for e in server_events}
print("server_only:", sorted(server_keys - client_keys))
print("client_only:", sorted(client_keys - server_keys))预期结果
server_only: [(102, 'destroy'), (102, 'hit')]
client_only: [(102, 'update')]这个结果说明双方在 tick=102 首次分叉:服务端已经命中并销毁,客户端仍把实体当作飞行中的投射物。真实项目中应进一步检查 hit 和 destroy 消息是否发送、是否到达,以及客户端是否正确处理销毁事件。
排查提前消失
如果客户端比服务端更早消失,优先检查本地计时器、最大飞行距离和客户端预测销毁逻辑。常见问题是客户端根据本地时间直接执行 lifetime 到期,而服务端因为时钟基准、Tick 或补偿策略尚未判定实体结束。
这类实现应让客户端的计时器承担表现用途,而不是权威销毁职责。服务端发送明确的结束状态或 destroy 事件后,客户端再删除实体;预测逻辑存在时,也应允许后续权威状态覆盖预测结果。
排查残留不消失
如果服务端已经销毁,但客户端仍然看到投射物,重点检查三个边界:消息是否真的送达、消息中的 projectileId 是否能命中本地对象、销毁处理是否被状态机或对象池拦截。
尤其要检查对象池复用。若客户端先销毁并回收对象,随后旧消息才到达,而实现仅按数组下标或旧引用删除,就可能误删新投射物或保留旧投射物。销毁操作应围绕稳定的实体 ID,并在处理前确认当前对象仍对应相同实体。
最短定位顺序
实际线上排查可以固定成一条顺序:先找 projectileId,再确认服务端 spawn,然后确认客户端收到 spawn;继续对比最后一次 update,最后核对 hit 与 destroy 的发送、到达和应用。
如果服务端日志完整而客户端缺少某个事件,先查网络传输和消息处理;如果两端事件都存在但状态不同,查客户端状态机与对象池;如果服务端自己就缺少 destroy,则回到命中判定、生命周期和销毁条件本身。这样可以把“投射物不同步”从画面现象缩小为一个明确的生命周期分叉点。