Unity3D中Physics.OverlapSphere Layer Mask不生效问题求助

核心错误：数组非空判断逻辑 #

Physics.OverlapSphere 永远不会返回 null——即使没有检测到任何碰撞体，它也会返回一个长度为0的空数组。你当前的判断条件 != null 永远为真，所以不管有没有玩家，代码都会执行。

正确的判断应该检查数组的长度是否大于0：

Collider[] hitColliders = Physics.OverlapSphere(transform.position, alertRange, playerMask);
if (hitColliders.Length > 0) {
    // do something
}

额外排查点：Layer Mask 有效性 #

如果修正判断后还是有问题，检查以下几点：

• 确认玩家对象的所有碰撞体都在「Player」层（不要只修改父物体，子物体的碰撞体层也要同步设置）。
• 检查 playerMask 的赋值：
  • 代码赋值时，确保使用 LayerMask.GetMask("Player") 而非直接写层索引（层索引可能随项目配置变化）。
  • Inspector 赋值时，确保只勾选「Player」层，不要误选其他层。
• 确认敌人的检测范围 alertRange 数值合理，避免因范围过小导致检测不到玩家。
• 检查玩家对象的碰撞体是否启用，且未勾选 isTrigger（默认 OverlapSphere 仅检测非触发器碰撞体，若需检测触发器需额外参数）。

内容的提问来源于stack exchange，提问作者Arcun Y.