游戏客户端架构 / 系统课时
空间计算排障清单怎么写
空间计算排障清单怎么写
“检查坐标系”太宽泛,无法指导下次复现。有效排障清单应说明要采样什么、与什么独立期望比较,以及失败后检查哪一层。本节把常见空间故障转成可重复执行的夹具与证据记录。
学习目标
- 按契约、变换、投影和时序组织检查
- 使用独立地标避免往返测试自证
- 保存足够重放问题的输入快照
清单从输入契约开始
先记录点或方向的语义、来源与目标空间、长度单位、角度单位、节点标识和采样阶段。然后检查数值是否有限、矩阵是否仿射、逆是否存在。输入契约未确定时,继续比较最终屏幕位置只会让多个错误互相抵消。
| 观察或检查 | 下一步证据 |
|---|---|
| 原点转换不符 | 对照节点世界位置与祖先链 |
| 原点正确,轴错 | 对照三条基轴与旋转顺序 |
| 长度随外观变化 | 对照缩放继承和单位方向 |
| 静态正确,运动抖动 | 对照同帧更新阶段与缓存版本 |
| 投影正确,UI 偏 | 对照视口偏移、DPI 与父局部映射 |
这些是定位顺序,不是凭现象直接判定根因。每次只改变一个因素,并保存改变前后的数值,避免同时改单位、矩阵顺序与 UI 偏移后无法解释为什么恢复正常。
独立夹具比互为逆更有力
往返检查证明正反函数一致,却不能证明符合真实约定。一个错误换轴和它的逆也能往返成功。应保留独立地标,例如明确的九十度转身后局部 (2,0,0) 应到世界 (10,2,0)。
以下使用 Python 3.12、NumPy 2.3.5,保存为 demo.py 执行 python demo.py。输出是当前夹具的检查结论,不把数值不符直接断言为某种唯一故障原因。
import numpy as np
def diagnose(matrix, point, expected):
if matrix.shape != (4, 4) or not np.all(np.isfinite(matrix)):
return "invalid values"
if not np.allclose(matrix[3], [0, 0, 0, 1]):
return "not affine"
if np.linalg.cond(matrix) > 1e10:
return "inverse unavailable"
result = matrix @ np.append(point, 1)
# 期望来自独立地标,而非再用待测矩阵算一遍。
if not np.allclose(result[:3], expected):
return "fixture mismatch"
restored = np.linalg.inv(matrix) @ result
return "passed" if np.allclose(restored[:3], point) else "roundtrip failed"
rotation = np.eye(4)
rotation[:3, :3] = [[0, -1, 0], [1, 0, 0], [0, 0, 1]]
translation = np.eye(4)
translation[:3, 3] = [10, 0, 0]
point, expected = [2, 0, 0], [10, 2, 0]
print("correct", diagnose(translation @ rotation, point, expected))
print("wrong_order", diagnose(rotation @ translation, point, expected))
print("zero_scale", diagnose(np.diag([0., 1, 1, 1]), point, expected))
projective = np.eye(4)
projective[3, 2] = -1
print("projective", diagnose(projective, point, expected))预期输出:
correct passed
wrong_order fixture mismatch
zero_scale inverse unavailable
projective not affine把复现记录写成可重放输入
记录引擎与项目版本、对象层级、相关节点局部 TRS、采样出的世界矩阵、相机视口矩形、原始鼠标位置、单位约定和预期结果。动画或物理参与时,还要记录关键姿态、固定时间步与查询过滤条件。只有一张错位截图,通常不足以重算问题。
投影问题单独保留裁剪坐标与 w,检查近远范围、相机前后和屏幕原点。射线问题保留起点、单位方向、最大距离与命中空间。UI 问题保留视口到窗口、窗口到父局部的两段映射,便于判断偏移与缩放究竟应用了几次。
自动检查应覆盖正常、边界和拒绝路径,例如零方向、零缩放、平行射线、跨角度插值、相机后方以及旧快照。容差根据坐标尺度与实际误差预算设置,不把所有偏差统一视为浮点问题。
修复完成后,把曾经失败的独立夹具留下,再验证真实运动场景。清单最后应给出证据与结果,而不是只写“已调整坐标”。能够从保存的输入重算同一终点,才意味着下一次出现类似问题时有可用的排查起点。