UE5警告VSM队列溢出解决方法

在运行 Unreal Engine 5 场景时，左上角偶尔会出现类似以下的黄色警告：

[VSM] Non-nanite Marking Job Queue overflow. Performance may be affected. This occurs when non-nanite meshes cover a large area of the shadow map.

这通常是在启用了 Virtual Shadow Maps (VSM) 且场景中存在大量 非 Nanite 静态网格（Static Mesh）时触发的。以下内容将分四大部分，逐步分析原因并给出多种可选的解决方案。

---

1. 原因分析

1.1 Virtual Shadow Maps 与 Nanite 的耦合

• VSM 设计时主要针对 Nanite 网格进行高效裁剪与渲染，能利用 Nanite 的虚拟化几何优势，避免不必要的页面（Page）分配与渲染开销。

• 对于 非 Nanite 网格，VSM 会退回到更昂贵的 Distance Field Shadows 或常规 Shadow Maps，导致大量小页面同时被请求，最终触发“队列溢出”警告。

1.2 场景中非 Nanite 网格覆盖范围过大

• 当非 Nanite 静态网格在 Shadow Map 中占据很大区域时，VSM 必须为每个小块（128×128 像素）都分配渲染任务，触发队列溢出。

• 例如，即使只是 50 个盒刷（Box Brush），在同一方向光下也可能出现此问题。

• 该警告同样在其他社区中多次被提及，包括 Archviz Facebook 群组。

---

2. 解决方案一：全面启用 Nanite

1. 在 Static Mesh 资产中启用 Nanite

   • 打开每个受影响的 Static Mesh 资源，勾选 Enable Nanite Support。

   • 这样可让这些网格在 VSM 中享受 Nanite 的高效页面管理，从根本上消除非 Nanite 网格带来的溢出。

2. 批量操作

   • 若资产数量庞大，可使用批量编辑工具或脚本，一次性为所有符合条件的网格开启 Nanite。

---

3. 解决方案二：关闭／切换 Shadow Map 方法

1. 在项目设置中切换回常规 Shadow Maps

   • 打开 Project Settings → Engine → Rendering → Shadows

   • 将 Shadow Map Method 从 “Virtual Shadow Maps” 改为 “Shadow Maps”。

   • 该操作会使所有阴影计算退回到传统的级联 Shadow Maps（CSM），彻底避免 VSM 溢出。

2. 运行时使用控制台变量

   • 在控制台或脚本中执行：

     pgsql

     复制编辑

     r.Shadow.Virtual.Enable 0

   • 动态禁用 VSM，恢复到常规阴影模式。

---

4. 解决方案三：优化非 Nanite 网格

1. 为非 Nanite 网格设置完整 LOD

   • 确保所有非 Nanite 资源均有合理的 LOD 层级，减少远处渲染时的面数。

2. 利用 Distance Field Shadows

   • 对于远距离非 Nanite 对象，可在 Directional Light 上设置 “Dynamic Shadow Distance Movable Light” 使其切换到距离场阴影，从而减轻 VSM 负担。

3. 调整裁剪阈值

   • 使用控制台变量：

     php-template

     复制编辑

     r.Shadow.RadiusThreshold <值>

   • 控制哪些小物体参与 VSM 渲染，避免无意义的小实例大量填充队列。

4. 合并与实例化

   • 对大量重复物体（如植被）使用 Hierarchical Instanced Static Mesh（HISM），大幅降低网格数量和渲染调用。

---

5. 何时可以忽略该警告

• 若场景在打包后性能稳定（如 90FPS 以上），且团队不打算深入 VSM 优化，可先忽略该警告，转为关注其他性能瓶颈。

---

通过以上多种手段，可根据项目需求灵活选择：

• 追求高质量阴影 → 全面启用 Nanite；

• 追求传统 Shadow Maps 兼容性 → 关闭 VSM；

• 兼顾场景复杂度 → 优化非 Nanite 网格与批量实例化。