UE5光照构建失败求助：触发地图检测报错，重启升级无效

问题描述 #

• 给UE5项目添加天光、定向光后，建筑内部出现异常光照（如无来源的亮块、漏光）
• 系统提示「光照需要重建」，但执行重建时弹出「光照构建失败」「地图检测发现错误」提示
• 已尝试重启电脑、升级UE5.1到5.1.1，问题仍未解决，日志显示地图存在光照计算相关错误

排查修复步骤 #

1. 检查模型几何体问题 #

• 打开世界大纲视图，筛选所有静态网格体，排查是否有重叠模型、非闭合结构（比如墙体有缺口、面缺失）
• 用静态网格体编辑器打开建筑模型，检查是否存在反转法线（法线朝内会导致光照计算混乱），可按Shift+N一键统一法线方向
• 删除或修正零厚度网格（比如完全扁平的面），这类网格会干扰Lightmass的光照计算

2. 校验光照组件设置 #

• 选中天光，将「天光类型」设为静态或固定，关闭「实时捕获」（动态天光和静态光照构建冲突）
• 定向光开启「动态阴影」，将「光照质量」调至高，确认「间接光照缓存」已启用
• 进入「项目设置-光照」，确保「静态光照质量」不是最低档，未配置RTX显卡的话关闭「使用硬件光线追踪」

3. 清理光照缓存并重建 #

• 点击编辑器顶部「构建-光照-高级选项-清理光照数据」，清空旧缓存后重新执行光照构建
• 打开日志窗口，搜索Lightmass Error关键词，定位具体出错的Actor或网格体，直接移除或替换该资源
• 若地图规模大，尝试拆分关卡为小区域，单独构建光照后再合并

4. 修复项目文件与引擎 #

• 关闭UE5，删除项目文件夹下的Saved/StagedBuilds和DerivedDataCache文件夹，重启项目
• 打开Epic启动器，找到UE5.1.1版本，点击「...」选择「验证」，修复缺失的引擎核心文件

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