在运行 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
在 Static Mesh 资产中启用 Nanite
打开每个受影响的 Static Mesh 资源，勾选 Enable Nanite Support。
这样可让这些网格在 VSM 中享受 Nanite 的高效页面管理，从根本上消除非 Nanite 网格带来的溢出。
批量操作
若资产数量庞大，可使用批量编辑工具或脚本，一次性为所有符合条件的网格开启 Nanite。
3. 解决方案二：关闭／切换 Shadow Map 方法
在项目设置中切换回常规 Shadow Maps
打开 Project Settings → Engine → Rendering → Shadows
将 Shadow Map Method 从 “Virtual Shadow Maps” 改为 “Shadow Maps”。
该操作会使所有阴影计算退回到传统的级联 Shadow Maps（CSM），彻底避免 VSM 溢出。
运行时使用控制台变量
在控制台或脚本中执行：
pgsql
复制编辑
r.Shadow.Virtual.Enable 0动态禁用 VSM，恢复到常规阴影模式。
4. 解决方案三：优化非 Nanite 网格
为非 Nanite 网格设置完整 LOD
确保所有非 Nanite 资源均有合理的 LOD 层级，减少远处渲染时的面数。
利用 Distance Field Shadows
对于远距离非 Nanite 对象，可在 Directional Light 上设置 “Dynamic Shadow Distance Movable Light” 使其切换到距离场阴影，从而减轻 VSM 负担。
调整裁剪阈值
使用控制台变量：
php-template
复制编辑
r.Shadow.RadiusThreshold <值>控制哪些小物体参与 VSM 渲染，避免无意义的小实例大量填充队列。
合并与实例化
对大量重复物体（如植被）使用 Hierarchical Instanced Static Mesh（HISM），大幅降低网格数量和渲染调用。
5. 何时可以忽略该警告
若场景在打包后性能稳定（如 90FPS 以上），且团队不打算深入 VSM 优化，可先忽略该警告，转为关注其他性能瓶颈。
通过以上多种手段，可根据项目需求灵活选择：
追求高质量阴影 → 全面启用 Nanite；
追求传统 Shadow Maps 兼容性 → 关闭 VSM；
兼顾场景复杂度 → 优化非 Nanite 网格与批量实例化。