Unity OnTriggerEnter2D碰撞后打印语句不执行无报错如何解决

问题现象 #

开发Unity游戏时实现2D碰撞检测逻辑，预期游戏对象与其他物体发生碰撞时控制台输出"hello"，实际碰撞触发后无任何响应，控制台无报错信息。
运行效果演示：

当前实现代码：

using System.Collections;
using System.Collections.Generic;
using UnityEngine;

public class kill : MonoBehaviour
{
    void OnTriggerEnter2D(Collider2D other)
    {
        print("hello");
    }
}

排查修复步骤 #

OnTriggerEnter2D是Unity 2D物理系统提供的触发器生命周期回调，必须满足2D触发器的全部生效条件才会被调用，按以下顺序逐一排查即可定位问题：

• 碰撞体组件校验：发生接触的两个游戏对象必须都挂载2D类型碰撞体（BoxCollider2D/CircleCollider2D/PolygonCollider2D等），且至少一方的碰撞体勾选Is Trigger属性。当前代码使用触发器回调，而非实体碰撞回调OnCollisionEnter2D，若没有碰撞体勾选Is Trigger，该回调永远不会执行。
• 刚体组件校验：两个接触对象中至少有一个挂载Rigidbody2D组件。不需要受力模拟的固定物体（如陷阱、地形障碍）可将Rigidbody2D的Body Type设为Kinematic，不可直接移除刚体：两个仅带碰撞体、无刚体的对象之间，物理系统不会计算任何碰撞、触发事件。
• 层级碰撞矩阵校验：打开Edit > Project Settings > Physics 2D面板，找到底部的Layer Collision Matrix配置，确认两个碰撞对象所属层级对应的交叉格为勾选状态，未勾选时对应层级的对象会直接忽略所有物理交互。
• 激活状态校验：挂载脚本的游戏对象、两个对象上的碰撞体与Rigidbody2D组件必须全部为启用状态（组件前的勾选框为选中状态），禁用状态下的对象和组件无法接收物理回调。
• 代码签名校验：确认回调方法参数类型为Collider2D（2D碰撞体类型），不要误写为3D物理的Collider类型；同时确认方法名拼写正确、返回值为void。签名不匹配时Unity不会抛出编译错误，只会无法识别为物理回调，方法内逻辑不会执行。
• 全局物理配置校验：在Physics 2D设置面板中确认Queries Hit Triggers选项为勾选状态，该选项关闭时全局所有触发器事件都不会触发。

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