游戏引擎 / 系统课时
排查角色穿墙和碰撞失效
排查角色穿墙和碰撞失效
穿墙可能来自形状没参与检测,也可能来自直接改位置、高速离散步进或不合适的刚体类型。本节先显示真实物理轮廓,再用最小场景区分“完全没有接触”和“高速时偶发漏检”。
学习目标
- 通过调试形状检查实际参与检测的对象
- 按后端、分组和运动方式缩小故障范围
- 评估固定步长与 bullet 的作用和成本
保留能复现的最小组合
复制问题场景,只保留 Player、一面足够厚的静态墙、相机和必要控制脚本。记录 Creator 版本、2D 后端、刚体类型、分组、速度、墙厚与异常时的帧时长。先关闭位置动画和多余控制器,保证只有物理系统推进 Player。
没有形状时查 Collider2D 是否启用、节点是否激活、碰撞器尺寸是否为零以及图片与碰撞器是否位于不同父节点。有形状却没有接触时查分组矩阵和刚体配对条件。sensor 会通知接触但不阻挡,不能靠添加更多事件监听把它变成墙。
开启并恢复调试绘制
保存 PhysicsDebugProbe.ts,挂到临时调试节点。项目选择 Box2D,场景含动态 Player 和静态 Wall;Player 上的 RigidBody2D 开启接触监听,另用日志确认接触是否发生。本例只控制调试显示,不修改全局步长或速度。
import { _decorator, Component, PhysicsSystem2D, EPhysics2DDrawFlags } from 'cc';
const { ccclass } = _decorator;
@ccclass('PhysicsDebugProbe')
export class PhysicsDebugProbe extends Component {
private previous = 0;
onEnable(): void {
const physics = PhysicsSystem2D.instance;
this.previous = physics.debugDrawFlags;
physics.debugDrawFlags = EPhysics2DDrawFlags.Shape | EPhysics2DDrawFlags.Aabb;
// 查看实际形状,不用 Sprite 外观猜测碰撞范围
console.log('physics-step:' + physics.fixedTimeStep.toFixed(4));
}
onDisable(): void {
// 临时诊断退出后恢复原设置
PhysicsSystem2D.instance.debugDrawFlags = this.previous;
}
}预期结果:支持调试绘制的预览中出现碰撞形状与包围盒线框,日志显示当前固定步长。常见 1/60 秒设置会显示约 physics-step:0.0167,实际输出以项目配置为准;没有预先指定步长时不能硬性要求这个数值。

根据速度改变复现条件
若低速稳定、高速穿墙,比较一个物理步长内的移动距离与墙厚,逐步降速、加厚墙体并记录结果。直接设置 position 的瞬移可能跨过整面墙,求解器没有机会沿途检测;应先修正运动入口,而不是只降低渲染帧率。
Box2D 的 bullet 选项面向高速动态刚体与其他运动刚体的连续检测,成本更高,且不是所有后端、类型和运动方式都适用。静态与运动学障碍的连续检测规则另有约束,不能把 bullet 解释成任意瞬移都不会穿墙的万能开关。只为实际需要的少量高速对象启用,并重新测试接触与性能。
减小固定时间步长可能增加求解次数,最大子步数则限制卡顿后追赶的工作量;二者须结合目标设备预算设置。不要在一个脚本里手动 step,又让系统自动模拟,导致重复推进。改变设置后用同一速度、墙厚和输入重跑,证明问题是否真正减少。
最后检查碰撞回调中是否直接销毁或修改物理结构,导致锁定期异常后逻辑中断。调试线框、接触日志、最终位置三者应一致;只看到事件日志并不能证明角色被正确阻挡。