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

用一张排障表定位物理异常

用一张排障表定位物理异常

碰撞问题从口头描述到修复验证,常常丢失最关键的速度、形状和时间步证据。本节提供一张可以直接填写的排障表,并用结构化记录检查报告是否完整,让每次修复都能被复现、解释和回归。

学习目标

  • 将现象、证据、假设和实验分别记录。
  • 为常见异常选择最小且可证伪的检查。
  • 保存修复前后相同输入的验收结果。

一行只表达一个假设

先描述能被观察到的现象,例如“速度 80 米每秒时穿过 0.1 米墙,物理步长 0.02 秒”,而不是“物理引擎坏了”。记录对象类型、实际形状、层过滤、移动来源和第一帧失败的位置。截图可以辅助说明,但不能替代逐步轨迹或可复现输入。

现象 要收集的证据 首个实验 修复验收
高速穿透 起终点、形状、相对速度、接触记录 保持场景,仅更换路径检测 高速与擦边不漏检
静止抖动 接触法线、穿透深度、姿态写入者 暂停额外姿态修改 静止及受推后稳定
贴墙卡住 净宽、输入与切向速度、摩擦配置 单块平墙斜向移动 滑动正常且不能穿墙
地面状态跳变 探测形状、距离、法线、支撑身份 换连续平面并绘制探针 边缘、坡面、跳起正确
伤害重复 攻击 ID、碰撞体对、订阅者、物理步 单目标单形状单监听器 多形状只结算设计次数
物理耗时突增 活跃体、接触、查询、回调、补步数 逐项暂停可疑业务 目标设备成本下降

表中首个实验用于缩小范围,并不是最终修复。换连续平面后正常,只能证明问题与原地形或其交互有关;还需要定位接缝、法线、缩放或探测范围。每次实验保留其他条件不变,结果不符合预测时应修正假设。

用最小记录防止漏字段

以下 Python 3 程序检查一条排障记录的关键字段。它只验证报告结构,不会判断根因是否正确;字段值来自教学案例,不是本机引擎的测试结果。真实项目可把同一结构保存到问题跟踪系统。

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

预期输出:

text
缺少字段: []
每步位移: 1.6

每步位移 1.6 米为穿透假设提供了线索,但过滤错误或纯触发器也可能没有接触事件。报告还应附上形状和响应设置,实验结果必须填写实际命中与成本,而不能仅写“已改 CCD”。

修复记录要包括反证

保存修复前失败输入、修复后的相同输入,以及至少一个边界负例。比如穿透修复后还要证明墙后目标不会被打中,卡墙修复后要证明窄门仍按尺寸阻挡,伤害去重后要证明下一次攻击仍能生效。

性能修复需要同设备、同种子、同负载和相同采样窗口的对照。记录物理步耗时和每帧步数,关闭调试绘制与逐事件日志。只有平均帧率提高、却出现更长尾部卡顿或漏碰撞时,不应判定验收通过。

让回归资产可以再次运行

归档最小场景、版本、物理后端、配置、输入种子、复现命令或编辑器操作、日志和验收阈值。动态对象 ID 可变化,但比对字段与对象角色应稳定。多人项目还要记录客户端与服务端谁决定最终姿态和伤害。

以后调整步长、角色尺寸、碰撞层或引擎版本时,先运行这组回归资产。排障表的价值在于把一次偶然正常变成可重复的行为约定,而不是积累一份越来越长的调参清单。

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

目录与阅读设置

阅读设置

17

记录一个想法

用一张排障表定位物理异常

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

登录哪都通