.NET MAUI：如何在Release模式下记录崩溃详情

一、捕获崩溃日志 #

• 使用Android Studio Logcat：将物理设备连接到电脑，打开Android Studio的Logcat面板，筛选你的应用包名，把日志级别设为Error。重新启动Release版本的应用，崩溃时重点查看AndroidRuntime开头的错误输出，这里会包含崩溃的堆栈轨迹。
• 使用ADB命令行：在终端执行adb logcat *:E输出所有错误日志，或者指定包名缩小范围：adb logcat -s 你的应用包名:E。如果需要保存日志到文件，执行adb logcat -d > crash_log.txt，之后可以打开文件分析完整的崩溃信息。
• 集成崩溃上报库：在MAUI项目中添加Crashlytics或App Center SDK，配置完成后，Release版本崩溃时会自动上传完整的崩溃堆栈到后台控制台，无需手动捕获日志。

二、启用Release版本的调试符号 #

在Android项目的.csproj文件中添加或修改以下配置，让Release构建生成完整的调试符号，避免崩溃日志出现混淆后的模糊栈信息：

<PropertyGroup>
  <AndroidEnableProfiledAot>false</AndroidEnableProfiledAot>
  <AndroidDebugSymbolType>full</AndroidDebugSymbolType>
  <AndroidUseSharedRuntime>false</AndroidUseSharedRuntime>
</PropertyGroup>

构建后保留生成的.pdb符号文件，后续可以用它解析混淆后的崩溃堆栈。

三、对比Debug与Release配置差异 #

• 检查AndroidManifest.xml：确认Release版本的权限声明、组件配置和Debug版本一致，比如是否遗漏了网络权限、文件访问权限等。
• 排查代码混淆（R8）：如果启用了<AndroidEnableR8>true</AndroidEnableR8>，尝试暂时将其设为false，重新构建Release包测试。若崩溃消失，说明是混淆规则导致的代码异常，需要添加对应的混淆排除规则。
• 核对依赖包：检查NuGet包的版本在Debug和Release下是否一致，部分包在Release模式下需要额外的初始化配置，或者存在兼容性问题。

四、本地调试Release版本 #

• 直接启动调试：在Visual Studio中选择Release配置，连接物理设备后点击调试按钮。虽然Release调试的信息有限，但可以捕获到未处理的异常信息。
• 附加进程调试：先通过adb install将Release APK安装到设备，然后执行adb shell am start -D 你的应用包名/你的主Activity全类名启动应用，此时应用会处于等待调试状态。在Visual Studio中选择“附加到进程”，找到对应的设备进程进行调试，可断点排查启动阶段的代码逻辑。

五、聚焦启动阶段代码排查 #

崩溃发生在启动屏之后，重点检查以下代码逻辑：

• App.xaml.cs中的OnStart、OnResume方法；
• MainPage的构造函数、初始化方法，尤其是异步初始化逻辑；
• Android平台特定代码：MainActivity.cs的OnCreate方法、平台服务的初始化代码，比如权限请求、原生组件加载等。

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