ThreeJs+CannonJs使用Raycast检测玩家是否落地返回空数组如何解决

问题说明 #

使用向下发射的射线检测玩家触地状态时，intersectObjects返回空数组，无法命中预期的地面Plane网格。

出错点排查 #

• 地面Plane朝向错误
  默认创建的THREE.PlaneGeometry面法向为Z轴正方向，属于竖直平面而非水平地面，向下发射的射线自然无法命中。如果已经手动旋转Plane作为地面，需确认Plane的正面朝向射线发射方向：从玩家位置向Y轴负方向发射的射线，需要地面Plane的法向为Y轴正方向（朝上），否则命中的是Plane背面，Three.js Raycaster默认会忽略背面检测。
• 射线参数配置错误
  实例化Raycaster时指定了far=10，需确认玩家底部到地面的垂直距离小于10，否则会超出射线检测范围。如果玩家模型的锚点在几何中心，射线起点建议适当向下偏移，避免起点与玩家自身网格重叠导致检测异常。另外你代码中的this._rayCaster.set()调用属于冗余操作，实例化Raycaster时已经完成了起点和方向的赋值，但该操作不会导致检测失败。
• 检测执行时机错误
  需确认执行射线检测时，地面Plane已经被添加到场景中，否则scene.children中不存在地面对象，无法命中。
• 图层匹配问题
  确认地面Plane的layers属性和Raycaster的layers属性匹配，默认两者都属于layer 0，如果你手动修改了地面的图层，会导致检测不到。

修复代码示例 #

// 第一步：初始化地面时确保朝向水平朝上
const groundGeometry = new THREE.PlaneGeometry(50, 50)
groundGeometry.rotateX(-Math.PI / 2) // 绕X轴旋转-90度，将法向改为Y轴正方向朝上
const ground = new THREE.Mesh(groundGeometry, new THREE.MeshBasicMaterial({ color: 0xcccccc }))
ground.position.y = 0
scene.add(ground)

// 第二步：优化射线检测逻辑
const DOWN_DIRECTION = new THREE.Vector3(0, -1, 0);
// 射线起点从玩家模型底部附近开始，避免检测到自身网格
const rayOrigin = this._player._mesh.position.clone().add(new THREE.Vector3(0, -0.1, 0))
this._rayCaster = new THREE.Raycaster(rayOrigin, DOWN_DIRECTION, 0, 10);
// 调试阶段可临时关闭背面剔除，确认是朝向问题后再按需调整
// this._rayCaster.cullFace = THREE.CullFaceNone
const intersects = this._rayCaster.intersectObjects(this._player._scene.children, true);
// 过滤掉玩家自身的交点，取第一个有效地面交点
const groundIntersect = intersects.find(item => item.object !== this._player._mesh)
console.log(groundIntersect)

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