Unity2019.2中BoxCastNonAlloc无命中但RaycastNonAlloc可正常检测的问题

在Unity 2019.2版本的开发流程中，开发者需要为带有固定宽度的光束武器实现BoxCast形式的碰撞检测。实际测试发现，同起点、同检测方向的Raycast方法可以正常完成光束碰撞检测，但替换为BoxCast实现后始终返回零命中结果。

测试全程没有设置任何深度、检测距离、LayerMask类的过滤条件。

可正常工作的射线检测实现：

colCountRay = Physics2D.RaycastNonAlloc(e.pos, Vector2.up, collsRay);

以上代码运行时可以正确填充collsRay数组，colCountRay会被赋值为实际检测到的命中对象数量，功能完全符合预期。

将射线检测代码替换为如下BoxCast实现后：

colCountRay = Physics2D.BoxCastNonAlloc(e.pos, Vector2.right, 0, Vector2.up, collsRay);

代码运行时colCountRay始终为0，无法检测到任何目标。

已经完成的排查验证项：

• 参考社区公开的BoxCast可视化校验方法，确认检测框与目标对象的空间重叠关系完全正确，不存在范围错位问题
• 开发者有其他项目中正常使用BoxCast功能的经验，排除对API基础用法的认知偏差
• 所有参与测试的对象均挂载了2D碰撞体，且绑定了运动学类型的Rigidbody2D组件
• 项目物理设置中已为所有对象启用Physics2D层碰撞规则，排除层碰撞配置导致的过滤问题

在完成以上排查后，问题依然没有得到解决，需要对应的故障排查思路。

内容的提问来源于stack exchange，提问作者David Coombes