ARKit开发问题：iPhone端土星.usdz模型环截断，Xcode预览正常

可能的原因 #

1. AR相机裁剪平面范围不匹配：ARKit默认的近/远裁剪平面可能无法覆盖光环的全部区域，行星球体在范围内，但光环部分超出了裁剪边界。
2. USDZ模型边界盒未包含光环：模型导出时边界盒仅计算了行星球体，未覆盖光环，导致ARKit基于错误的边界盒做视锥体裁剪优化，误裁了光环。
3. 模型局部坐标导致裁剪：光环子节点的局部坐标位置，使得部分区域落在相机视锥体之外，触发ARKit的自动裁剪。

具体解决步骤 #

1. 调整ARView相机裁剪平面参数 #

手动设置相机的近、远裁剪面范围，确保覆盖光环全部区域：

// 初始化ARView后直接设置
arView.sceneView.pointOfView?.camera?.zNear = 0.001
arView.sceneView.pointOfView?.camera?.zFar = 2000.0

2. 修正模型边界盒 #

强制重新计算模型的边界盒，确保包含所有子节点（包括光环）：

bodyEntity = try! ModelEntity.loadModel(named: "saturn_model.usdz")
// 重新计算边界盒
bodyEntity.updateBounds()
bodyEntity.scale = SIMD3<Float>(1.0, 1.0, 1.0)

如果知道光环的尺寸范围，也可以手动设置更大的边界盒：

bodyEntity.boundingBox = simd_bounds(min: SIMD3<Float>(-5, -5, -5), max: SIMD3<Float>(5, 5, 5))

3. 调整模型位置与局部坐标 #

将模型放置在相机视野中心区域，避免光环部分过于靠近或远离相机：

// 将模型放在相机前方1米处
bodyEntity.position = simd_make_float3(0, 0, -1)

同时检查光环子节点的局部坐标，确认没有超出合理范围。

4. 临时禁用裁剪优化（排查验证） #

禁用ARView的视锥体裁剪，确认是否为裁剪导致的问题：

arView.sceneView.cullingStrategy = .never

如果禁用后光环显示完整，就说明是裁剪范围或边界盒的问题，再针对性调整参数。

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