实现物体抓取功能时手部含Rigidbody导致Physics.OverlapSphere返回空

• 层掩码配置错误：Unity的OverlapSphere第三个参数是按位计算的层掩码，如果你直接把层序号赋值给grabbableLayer（比如错误写为grabbableLayer = LayerMask.NameToLayer("Grabbable")），添加Rigidbody后物理引擎的层过滤规则会生效，直接过滤掉所有目标层的碰撞体。正确的层掩码写法应为1 << LayerMask.NameToLayer("Grabbable")，你可以先打印掩码的二进制值确认是否包含你需要的层。
• 层碰撞交互被关闭：打开Unity编辑器的Edit > Project Settings > Physics面板，检查碰撞矩阵中，手部模型所在层和grabbableLayer对应的层是否勾选了交互许可。添加Rigidbody后物理引擎会严格遵循碰撞矩阵的规则，要是两层的交互被关闭，OverlapSphere会直接返回空。
• 查询时机和物理更新不同步：如果你的OverlapSphere逻辑写在Update中，添加Rigidbody后，物理位置更新在FixedUpdate中执行，可能出现逻辑帧查询时，手掌位置还没同步到物理引擎缓存的情况，导致查询不到范围内的碰撞体，把查询逻辑挪到FixedUpdate中即可验证该问题。
• 碰撞体查询属性设置异常：Unity 2020及之后版本的Collider组件新增了includeQueries相关配置，如果可抓取物体的碰撞体被设置为不参与物理查询，或者你调用OverlapSphere时没有显式指定QueryTriggerInteraction参数，而可抓取物体用了Trigger碰撞体，也会出现返回空的情况。

你可以用下方调试代码先确认问题根源：

// 打印层掩码二进制，确认配置是否正确
Debug.Log($"当前层掩码：{Convert.ToString(grabbableLayer, 2)}");
// 显式指定查询参数，排除Trigger和自身干扰
Collider[] grabbableColliders = Physics.OverlapSphere(palm.position, reachDistance, grabbableLayer, QueryTriggerInteraction.Collide);
Debug.Log($"查询到碰撞体数量：{grabbableColliders.Length}");
foreach (var collider in grabbableColliders)
{
    Debug.Log($"碰撞体名称：{collider.gameObject.name}，所属层：{LayerMask.LayerToName(collider.gameObject.layer)}");
}

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