PhysX胶囊体重叠查询误判问题求助

问题现象 #

• 使用Capsule碰撞器执行场景查询时，physx::PxGeometryQuery::overlap()返回true，但在PVD中可见胶囊体仅距离较近并未实际碰撞
• OnTrigger/onContact函数仅在实际碰撞时触发，说明PxGeometry配置正确，但overlap查询结果与触发逻辑不一致
• 仅胶囊体碰撞器存在该偏移问题，盒体、球体碰撞器功能正常

代码片段 #

for (auto& collider2 : actor2->m_colliders)
{
    bool isOverlapping = physx::PxGeometryQuery::overlap(collider->GetPhysXShape()->getGeometry().any(), actor1->GetPhysXActor().getGlobalPose(), collider2->GetPhysXShape()->getGeometry().any(), actor2->GetPhysXActor().getGlobalPose());
    if (isOverlapping)
        return true;
}

可能的原因及解决办法 #

1. 忽略碰撞器的接触偏移（Contact Offset）
   PhysX碰撞器默认带有0.02m的接触偏移，用于避免高频碰撞抖动。PxGeometryQuery::overlap()会将该偏移纳入计算，而OnTrigger/onContact的触发逻辑可能受场景接触阈值或过滤规则影响，导致判定不一致。

   • 解决：临时将接触偏移设为0后再执行查询，完成后恢复原值：

     // 保存原接触偏移
     PxReal offset1 = collider->GetPhysXShape()->getContactOffset();
     PxReal offset2 = collider2->GetPhysXShape()->getContactOffset();
     
     collider->GetPhysXShape()->setContactOffset(0.0f);
     collider2->GetPhysXShape()->setContactOffset(0.0f);
     
     bool isOverlapping = physx::PxGeometryQuery::overlap(
         collider->GetPhysXShape()->getGeometry().any(), 
         actor1->GetPhysXActor().getGlobalPose(), 
         collider2->GetPhysXShape()->getGeometry().any(), 
         actor2->GetPhysXActor().getGlobalPose()
     );
     
     // 恢复原偏移
     collider->GetPhysXShape()->setContactOffset(offset1);
     collider2->GetPhysXShape()->setContactOffset(offset2);
     

2. 胶囊体几何参数或轴向不匹配
   检查两个胶囊体的轴向（PxCapsuleGeometry::axis）是否一致，若一个为X轴、另一个为Y/Z轴，可能导致几何计算偏差。同时确认胶囊体的半高（halfHeight）和半径（radius）参数与PVD显示的一致，避免代码中参数配置错误。

3. 改用场景级Overlap查询
   直接调用场景的overlap方法，该方法会遵循运行时的碰撞过滤规则和接触偏移逻辑，与OnTrigger/onContact的判定逻辑更一致：

   PxOverlapBuffer hitBuffer;
   PxSceneQueryFilterData filterData;
   filterData.data.word0 = PxFilterFlag::eDEFAULT; // 根据需求调整过滤规则
   
   bool isOverlapping = actor1->GetPhysXActor().getScene()->overlap(
       collider->GetPhysXShape()->getGeometry().any(), 
       actor1->GetPhysXActor().getGlobalPose(), 
       hitBuffer,
       filterData
   );
   

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