React Native Windows构建成功但UWP应用首次启动渲染组件时崩溃求助

一、先收集崩溃核心信息 #

• 打开事件查看器，定位到Windows日志 > 应用程序，筛选来源为Application Error或Windows Error Reporting的事件，找到对应崩溃记录，重点查看异常代码（如0xC0000005）和故障模块名称，这是定位问题的关键依据。
• 用VS2022附加进程调试：先尝试启动应用（会崩溃），然后在VS中选择调试 > 附加到进程，勾选显示所有用户的进程，找到你的应用进程（若崩溃过快，可提前打开附加窗口等待），附加成功后重新启动应用，捕获崩溃时的调用栈信息。

二、校验环境与依赖完整性 #

• 确认.NET 6.0 SDK组件：打开控制面板 > 程序和功能，搜索.NET 6.0，确保同时安装了Microsoft .NET 6.0 Runtime - Windows Desktop和Microsoft .NET 6.0 Runtime（UWP依赖的基础运行时）。
• 检查VS2022 UWP组件：打开VS安装器，确认勾选通用Windows平台开发 workload，且组件中包含对应系统版本的Windows 10 SDK（你的Win10 21H2对应10.0.19041.x版本），以及.NET Native工具链（UWP调试和发布的核心组件）。
• 验证开发者模式配置：进入设置 > 更新和安全 > 开发者选项，确认开发人员模式已开启，且允许开发人员使用任意代码调试选项已勾选，完成后重启电脑生效。

三、检查项目配置细节 #

• 核对Package.appxmanifest：
  • 应用程序标签下的入口点是否正确（React Native for Windows项目需指向生成的exe和对应入口类，如YourAppName.exe和YourAppName.App）；
  • 功能标签下是否勾选了应用启动必需的权限（如互联网、私有网络访问权限）。
• 确认项目版本适配：在VS中右键项目 > 属性 > 应用，将目标版本和最低版本均设置为Win10 21H2对应的10.0.19041.0，避免版本不兼容。

四、清理缓存与重新部署 #

• 清理React Native缓存：在项目根目录执行命令：

  npx react-native start --reset-cache
  

  之后重新执行npm run windows。
• 清理VS项目缓存：删除项目目录下的bin、obj文件夹，以及windows目录下的build文件夹，再重新生成解决方案。
• 彻底卸载应用：用PowerShell执行命令（替换YourAppName为你的应用名称）：

  Get-AppxPackage *YourAppName* | Remove-AppxPackage
  

  卸载完成后再重新安装调试。

五、针对性调试排查 #

• 启用VS详细调试输出：进入工具 > 选项 > 调试 > 输出窗口，勾选所有常规输出选项，启动调试时查看输出日志，排查是否有依赖加载失败、权限不足或初始化异常的提示。
• 检查启动初始化代码：若项目自定义了App.xaml.cs的OnLaunched方法或React Native的启动逻辑，在关键代码块添加try-catch捕获异常，输出详细错误信息到调试窗口，定位具体崩溃点。

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