为何OnTriggerEnter2D触发正常但CompositeCollider2D.OverlapCollider返回0？

你遇到的这种情况不属于正常现象，核心是代码使用方式或参数配置存在问题，下面拆解原因并给出对应解决办法：

核心原因 #

1. ContactFilter2D 默认过滤规则限制
   默认的ContactFilter2D会自动排除触发器碰撞体，且层掩码可能不包含目标对象所在层，导致检测时直接过滤掉匹配项，返回结果为0。

2. OverlapCollider 使用逻辑错误
   你传入的new Collider2D[] {assailables[i].GetComponent<Collider2D>()}是输出数组，用来存储检测到的所有碰撞体，而非指定要检测的目标对象。仅传单元素数组且过滤规则不匹配时，自然返回0。

3. CompositeCollider2D 未同步更新
   如果CompositeCollider2D是动态生成/修改的（比如子物体增减Collider），未及时同步碰撞几何体，会导致检测时的碰撞范围和OnTriggerEnter2D触发时不一致。

解决代码示例 #

1. 配置正确的ContactFilter2D #

先设置符合需求的过滤规则，比如允许检测触发器、匹配目标层：

// 配置碰撞过滤规则
var contactFilter = new ContactFilter2D();
// 替换为你的目标对象所在层名
contactFilter.SetLayerMask(LayerMask.GetMask("Enemy", "Player")); 
// 若目标对象的Collider是触发器，必须开启此选项
contactFilter.useTriggers = true;

2. 正确调用OverlapCollider并验证目标 #

创建足够大的数组接收检测结果，遍历结果判断目标是否仍在范围内：

CompositeCollider2D groundArea = GetComponent<CompositeCollider2D>();
// 预创建足够大的数组，避免频繁GC
Collider2D[] detectionResults = new Collider2D[20];

// 倒序遍历，避免移除元素后跳过后续项
for (int i = assailables.Count - 1; i >= 0; i--)
{
    var targetTransform = assailables[i];
    var targetCollider = targetTransform.GetComponent<Collider2D>();
    
    // 先判断目标碰撞体是否有效
    if (targetCollider == null || !targetCollider.enabled)
    {
        assailables.RemoveAt(i);
        continue;
    }

    // 执行碰撞检测
    int hitCount = groundArea.OverlapCollider(contactFilter, detectionResults);
    bool isStillInside = false;

    // 遍历检测结果，确认目标是否在范围内
    for (int j = 0; j < hitCount; j++)
    {
        if (detectionResults[j].transform == targetTransform)
        {
            isStillInside = true;
            break;
        }
    }

    // 不在范围内则移除
    if (!isStillInside)
    {
        assailables.RemoveAt(i);
    }
}

3. 确保CompositeCollider2D及时更新 #

如果CompositeCollider2D是动态修改的，需要手动触发几何体更新：

// 修改子物体Collider后调用，同步碰撞形状
groundArea.GenerateGeometry();
// 或者在组件面板开启「Auto Sync Transforms」选项，自动同步

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