Unity 2021.3.24f1 LTS部署MRTK3示例场景到Hololens 2崩溃求助

一、MRTK3与Unity版本兼容性明确 #

• MRTK3官方仅支持Unity 2021.3.x LTS版本，2020.x系列版本因XR模块功能缺失，无法运行MRTK3示例场景，属于预期限制
• 推荐使用Unity 2021.3.20+ LTS版本，该区间版本的XR模块稳定性更适配MRTK3

二、部署崩溃问题排查修复步骤 #

1. 确认MRTK3源码完整性 #

克隆mrtk3分支时必须拉取完整子模块，执行以下命令补全依赖：

git submodule update --init --recursive

子模块缺失会导致运行时核心资源加载失败，引发启动崩溃。

2. 修正Unity项目核心配置 #

• 打开Player Settings > XR Plugin Management，勾选OpenXR，并添加Hololens 2配置
• 设置Scripting Runtime Version为**.NET 4.x Equivalent**，Api Compatibility Level为**.NET Standard 2.1**
• 关闭Player Settings > Other Settings中的Graphics Jobs选项，该选项在部分2021.3版本中会导致Hololens 2运行时崩溃

3. 清理重建项目 #

• 删除项目根目录下的Library文件夹，重新打开Unity让资源重新导入，解决缓存导致的资源冲突
• 构建时勾选Development Build和Script Debugging，通过Visual Studio远程调试Hololens 2，查看崩溃时的具体报错日志，定位问题根源

4. 升级Hololens 2系统版本 #

将头显系统更新至Windows Holographic 22H2及以上版本，旧系统版本存在与MRTK3的兼容性漏洞

5. 简化场景测试 #

先创建空场景，仅添加MRTK3ConfigurationProfile和XR Origin (VR)组件，部署测试是否能正常启动。若正常，再逐步添加示例场景中的功能组件，排查具体引发崩溃的模块

内容的提问来源于stack exchange，提问作者cyprien fol