Unity URP + XR 自定义 Skybox 在真机变黑问题全解析与解决方案（支持 Pico、Quest 等一体机）

在使用 Unity 的 URP 渲染管线开发 XR 应用（如 Pico Neo、Pico 4、Quest 2/3 等一体机）时，很多开发者遇到一个奇怪的问题：

打包后，Skybox（天空盒）在某些角度下突然变黑，只在转动头部后才恢复正常。

这个问题在编辑器和 PC 运行时完全看不出来，只有打包部署到 XR 设备上才会复现，尤其是在 URP 渲染管线 + 自定义 Skybox 材质 + 开启 Single-Pass Instanced 或 Multiview 渲染模式 的场景中尤为常见。

根因解析：URP Skybox Pass 在 XR 中未正确处理 Stereo 宏

它的真实根因是：

Unity URP 的 Skybox 渲染 Pass 在 XR 模式下，仍使用了一套旧的、依赖 Stereo 宏的方式处理双眼渲染（Instancing/Multiview），而如果你的 Shader（比如自定义的 ASE Shader）没有包含这些宏，就只能渲染一个眼睛或直接跳过该 pass。

详见 Unity 官方 Issue 跟踪：

• Unity Issue Tracker: Skybox missing in right eye when using URP + XR

• Unity 将此问题在 2022 LTS 标记为 Won’t Fix，但在 2023.2+ 新版本中已重构 URP XR 渲染路径修复此问题。

解决方案

1、Shader 中加入

#pragma multi_compile _ STEREO_INSTANCING_ON STEREO_MULTIVIEW_ON

2、升级 Unity 至 2023.2+ 或 2024.1+

3、或者临时改用 Multi-Pass 模式