游戏客户端架构 / 系统课时
用一张排障表定位物理异常
用一张排障表定位物理异常
碰撞问题从口头描述到修复验证,常常丢失最关键的速度、形状和时间步证据。本节提供一张可以直接填写的排障表,并用结构化记录检查报告是否完整,让每次修复都能被复现、解释和回归。
学习目标
- 将现象、证据、假设和实验分别记录。
- 为常见异常选择最小且可证伪的检查。
- 保存修复前后相同输入的验收结果。
一行只表达一个假设
先描述能被观察到的现象,例如“速度 80 米每秒时穿过 0.1 米墙,物理步长 0.02 秒”,而不是“物理引擎坏了”。记录对象类型、实际形状、层过滤、移动来源和第一帧失败的位置。截图可以辅助说明,但不能替代逐步轨迹或可复现输入。
| 现象 | 要收集的证据 | 首个实验 | 修复验收 |
|---|---|---|---|
| 高速穿透 | 起终点、形状、相对速度、接触记录 | 保持场景,仅更换路径检测 | 高速与擦边不漏检 |
| 静止抖动 | 接触法线、穿透深度、姿态写入者 | 暂停额外姿态修改 | 静止及受推后稳定 |
| 贴墙卡住 | 净宽、输入与切向速度、摩擦配置 | 单块平墙斜向移动 | 滑动正常且不能穿墙 |
| 地面状态跳变 | 探测形状、距离、法线、支撑身份 | 换连续平面并绘制探针 | 边缘、坡面、跳起正确 |
| 伤害重复 | 攻击 ID、碰撞体对、订阅者、物理步 | 单目标单形状单监听器 | 多形状只结算设计次数 |
| 物理耗时突增 | 活跃体、接触、查询、回调、补步数 | 逐项暂停可疑业务 | 目标设备成本下降 |
表中首个实验用于缩小范围,并不是最终修复。换连续平面后正常,只能证明问题与原地形或其交互有关;还需要定位接缝、法线、缩放或探测范围。每次实验保留其他条件不变,结果不符合预测时应修正假设。
用最小记录防止漏字段
以下 Python 3 程序检查一条排障记录的关键字段。它只验证报告结构,不会判断根因是否正确;字段值来自教学案例,不是本机引擎的测试结果。真实项目可把同一结构保存到问题跟踪系统。
required = ("symptom", "repro", "evidence", "hypothesis", "experiment", "acceptance")
report = {
"symptom": "高速球穿过薄墙",
"repro": {"step_s": 0.02, "speed_m_s": 80, "wall_m": 0.1},
"evidence": ["起终点均不重叠", "没有接触事件"],
"hypothesis": "离散采样跨过墙",
"experiment": "保持速度与形状,仅改为路径扫掠",
"acceptance": ["正面命中", "斜向擦边", "移动目标", "记录每步查询成本"],
}
# 空字符串和空列表也视为缺少内容。
missing = [key for key in required if not report.get(key)]
print("缺少字段:", missing)
print("每步位移:", report["repro"]["step_s"] * report["repro"]["speed_m_s"])预期输出:
缺少字段: []
每步位移: 1.6每步位移 1.6 米为穿透假设提供了线索,但过滤错误或纯触发器也可能没有接触事件。报告还应附上形状和响应设置,实验结果必须填写实际命中与成本,而不能仅写“已改 CCD”。
修复记录要包括反证
保存修复前失败输入、修复后的相同输入,以及至少一个边界负例。比如穿透修复后还要证明墙后目标不会被打中,卡墙修复后要证明窄门仍按尺寸阻挡,伤害去重后要证明下一次攻击仍能生效。
性能修复需要同设备、同种子、同负载和相同采样窗口的对照。记录物理步耗时和每帧步数,关闭调试绘制与逐事件日志。只有平均帧率提高、却出现更长尾部卡顿或漏碰撞时,不应判定验收通过。
让回归资产可以再次运行
归档最小场景、版本、物理后端、配置、输入种子、复现命令或编辑器操作、日志和验收阈值。动态对象 ID 可变化,但比对字段与对象角色应稳定。多人项目还要记录客户端与服务端谁决定最终姿态和伤害。
以后调整步长、角色尺寸、碰撞层或引擎版本时,先运行这组回归资产。排障表的价值在于把一次偶然正常变成可重复的行为约定,而不是积累一份越来越长的调参清单。