为什么HoloLens 2模拟器运行Unity项目时会显示黑屏？

可用日志排查路径 #

• 读取Unity引擎本地运行日志：UWP应用部署后，日志默认存放于路径%USERPROFILE%\AppData\Local\Packages\[应用包名]\TempState\UnityPlayer.log，可捕获引擎初始化、资源加载、脚本执行阶段的所有报错，不受Visual Studio输出窗口限制
• 查询系统应用事件日志：打开HoloLens模拟器的事件查看器，定位到「Windows日志 > 应用程序」，筛选来源为UnityPlayer或对应应用的事件条目，可排查权限不足、运行时依赖缺失等系统层面的故障
• 启用MRTK诊断组件：在Unity编辑器的MRTK配置文件中开启诊断系统，打包后会在运行界面显示实时错误告警、性能参数，可直接定位MRTK核心组件初始化失败类问题

高频故障修复方案 #

• 清理模拟器残留缓存：多次部署不同测试项目后，模拟器会残留旧应用的缓存与配置冲突，可进入模拟器系统设置的存储页面，删除所有过往测试应用包，重启模拟器后再重新部署
• 校验UWP构建配置：Unity Build Settings中确认目标SDK版本为19041及以上，最低平台版本设为18362，架构固定选择x64，仅保留Direct3D 11作为唯一图形API，关闭其他未兼容的图形接口选项
• 调整场景加载顺序：确认MRTK初始化场景已加入Build Settings的场景列表，且加载优先级高于业务场景，避免MRTK核心输入、渲染组件未完成初始化就进入业务场景导致渲染失效
• 禁用不必要的调试选项：非必要情况下关闭「Script Debugging」「Profiler」等调试功能，这类功能注入的调试组件可能与模拟器运行环境冲突，导致启动无响应黑屏

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