如何调试调试器正常运行但真机（Ad Hoc/AppStore）崩溃的MAUI应用

一、获取真机崩溃日志 #

• 连接iOS真机到Mac，打开Xcode的Window > Devices and Simulators，选中目标设备后点击View Device Logs，筛选应用对应的崩溃记录，通过堆栈信息定位崩溃的具体代码位置。
• 若无Mac，可在iOS设备的设置 > 隐私与安全性 > 分析与改进 > 分析数据中找到带应用名和.crash后缀的日志文件，导出后分析关键报错信息。

二、排查分发模式的配置差异 #

• 链接器优化问题：MAUI在Release模式默认启用全量链接优化，可能误删必要代码。可在项目文件的iOS配置中添加<MtouchLink>SdkOnly</MtouchLink>，或给核心类/方法添加[Preserve]属性，避免被链接器移除。
• 权限配置缺失：真机权限要求比模拟器严格，检查Info.plist是否添加了所有必要的权限描述（如相机、网络、位置等），缺失权限可能触发崩溃。
• 签名与证书验证：确认Ad Hoc分发的Provisioning Profile包含目标设备UDID，AppStore分发的签名使用有效分发证书，签名异常会导致应用启动即崩溃。

三、解决Application Insights适配问题 #

• 更新Microsoft.ApplicationInsights.Maui包至最新版本，修复模拟器与真机的适配bug。
• 在Release模式下，给Application Insights的初始化类添加[Preserve]属性，或在项目文件中配置链接器规则保留其程序集，避免初始化代码被优化移除。
• 暂时禁用Application Insights，测试真机是否仍崩溃，排除AI组件导致的问题。

四、直接调试Release模式的真机应用 #

• 连接iOS真机后，在Visual Studio中切换至Release配置，选择真机作为调试目标启动调试，捕获运行时异常（虽调试信息有限，但能直观定位问题）。
• 若Visual Studio调试受限，可使用Xcode的Attach to Process功能，附加到运行中的应用进程，查看实时日志与异常。

五、检查第三方依赖兼容性 #

• 排查应用使用的第三方NuGet包，确认其支持iOS分发模式。部分包在Debug模式正常，但Release模式下因ARM64架构适配问题崩溃，可尝试更新包版本或替换为兼容组件。

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