Hololens 2部署Unity应用报错:XR_ERROR_RUNTIME_UNAVAILABLE
以下是针对该问题的具体排查和解决步骤:
检查Hololens 2系统固件更新
Hololens 2的OpenXR运行时依赖最新系统组件,前往设备的设置 > 更新和安全 > Windows更新,确保设备已安装所有可用更新。旧版本系统可能缺失XR运行时的必要文件,导致初始化失败。验证设备OpenXR运行时状态
在设备中打开设置 > 系统 > 混合现实 > OpenXR,确认OpenXR runtime已设置为Windows Mixed Reality,且无异常提示。若此处显示错误,说明系统层面XR运行时损坏,可备份数据后重置设备。确认Unity打包架构与部署配置
- Unity构建设置中,目标架构必须选择
ARM64(Hololens 2仅支持64位架构),避免选择x86/x64。 - Visual Studio部署时,目标选择
Device,配置切换为Release(Debug模式可能存在额外初始化冲突)。
- Unity构建设置中,目标架构必须选择
清理部署缓存并重新生成项目
- 删除Unity导出的Visual Studio项目文件夹,重新导出项目。
- 在VS中执行
Build > Clean Solution,重新构建部署。同时在Hololens 2上卸载旧应用,通过设置 > 应用 > 对应应用 > 高级选项 > 重置清理缓存。
复查MRTK XR配置细节
- MRTK3:确认
MRTK XR Settings中勾选Initialize XR on Startup,OpenXR Feature Groups包含HoloLens Feature Group,且OpenXR Settings的Runtime设为Windows Mixed Reality。 - MRTK2:确认
XR Plugin Management启用Windows Mixed Reality插件,Windows Mixed Reality Settings中勾选Initialize XR on Startup,Depth Submission Mode设为Depth 16-bit。
- MRTK3:确认
核对应用权限配置
在Unity的Player Settings > Publishing Settings > Capabilities中,确保勾选InternetClient、PrivateNetworkClientServer、SpatialPerception、GazeInput这些XR应用必需的权限,缺失权限可能导致运行时初始化失败。手动安装OpenXR运行时(极端场景)
若系统更新后问题仍存在,可在Hololens 2的Microsoft Store中搜索并安装Windows Mixed Reality OpenXR Runtime,安装完成后重启设备。
内容的提问来源于stack exchange,提问作者volkanigde
相关产品推荐
相关产品推荐

