.NET MAUI Android发布版异常无法捕获问题求助

问题现象 #

在.NET MAUI Android的Release构建中，托管代码的try/catch块无法捕获预期异常，导致应用直接崩溃；但Debug构建下可正常捕获并处理异常。

测试代码 #

try
{
   Flog.Info("Force exception. Should be caught and logged next...");
   object someObj = null; 
   someObj.GetType();
}
catch (Exception e)
{
   Flog.Error(e); // Log error
}

构建日志对比 #

• Release构建日志：

[2024-08-26][18:50:01.0863]:INFO:Force an exception. Should be caught and logged next...
// 无后续日志，应用直接崩溃

• Debug构建日志：

[2024-08-26][18:56:07.0897]:INFO:Force exception. Should be caught and logged next...
[2024-08-26][18:56:11.0326]:ERROR:DescriptionModels.DescriptiveText:Object reference not set to an instance of an object....

额外测试结果 #

调用NetworkInformation.Ping类（仅调用一次，无需持续运行）后，触发空引用异常时，Release版应用直接崩溃，异常完全无法被try/catch捕获；Debug版则能正常捕获并记录异常。已在官方仓库提交Issue #24545。

可能原因 #

1. 链接器/代码收缩优化：Release构建默认启用链接器优化，可能误移除异常捕获相关代码或改变执行路径，导致托管异常无法被正确捕获。
2. AOT编译特性：.NET MAUI Android Release构建默认开启AOT编译，部分场景下AOT编译的异常处理逻辑与Debug下的JIT模式不一致，尤其是涉及跨托管/原生边界的调用（比如NetworkInformation.Ping调用原生系统API）。
3. 原生层异常穿透：调用NetworkInformation.Ping后，原生层可能产生未被正确包装的异常，直接绕过托管代码的try/catch逻辑导致崩溃。

解决办法 #

1. 调整链接器设置

   • 在项目.csproj文件中，针对Android平台添加链接器排除规则，确保异常处理相关代码不被移除：

     <PropertyGroup Condition="'$(TargetFramework)' == 'net8.0-android'">
         <AndroidLinkMode>Full</AndroidLinkMode>
         <AndroidLinkSkip>YourAssemblyName;Microsoft.Maui.Network</AndroidLinkSkip>
     </PropertyGroup>
     

   • 可临时将AndroidLinkMode设为None（仅用于排查，不建议长期使用，会增大APK体积），验证是否为链接器导致的问题。

2. 禁用特定AOT优化

   • 在.csproj中添加AOT排除规则，针对异常处理相关代码或NetworkInformation.Ping相关代码禁用AOT：

     <PropertyGroup Condition="'$(TargetFramework)' == 'net8.0-android'">
         <AndroidAotAdditionalArguments>--exclude assemblies=YourAssemblyName.dll</AndroidAotAdditionalArguments>
     </PropertyGroup>
     

3. 全局异常捕获兜底

   • 注册应用级全局异常处理事件，捕获未被局部try/catch处理的异常，避免应用直接崩溃：

     // 在App.xaml.cs的构造函数或OnStart方法中添加
     AppDomain.CurrentDomain.UnhandledException += (sender, e) =>
     {
         var ex = e.ExceptionObject as Exception;
         Flog.Error($"Unhandled exception: {ex?.Message}", ex);
     };
     
     AndroidEnvironment.UnhandledExceptionRaiser += (sender, e) =>
     {
         Flog.Error($"Android unhandled exception: {e.Exception.Message}", e.Exception);
         e.Handled = true; // 标记为已处理，避免系统崩溃弹窗
     };
     

4. 规避NetworkInformation.Ping的影响

   • 如果问题仅在调用Ping后出现，可尝试替换为其他网络检测方式（比如使用HttpClient发起简单请求），绕过原生Ping组件带来的异常处理问题。

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