MAUI应用在Lenovo Tab M8真机启动后崩溃求助

问题背景 #

• 开发环境：VS Code + .NET 8.0.405 + MAUI 8.0.100，环境配置已按官方文档验证无误
• 异常现象：应用在模拟器运行正常，但在Lenovo Tab M8（Android 13）真机启动后立即崩溃；使用官方默认模板创建的无修改项目也复现该问题
• 已提供日志：完整logcat、过滤后logcat、VS Code调试日志

可能原因及对应解决步骤 #

1. Android 13权限适配缺失

Android 13新增了POST_NOTIFICATIONS权限，MAUI 8默认模板可能未包含该权限，导致应用启动时触发权限异常崩溃。

• 解决：在Platforms/Android/AndroidManifest.xml中添加权限声明：

  <uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
  

  若应用需要推送通知，可在启动时动态请求权限：

  if (Build.VERSION.SdkInt >= BuildVersionCodes.Tiramisu)
  {
      var permissionStatus = await Permissions.CheckStatusAsync<Permissions.PostNotifications>();
      if (permissionStatus != PermissionStatus.Granted)
      {
          permissionStatus = await Permissions.RequestAsync<Permissions.PostNotifications>();
      }
  }
  

2. ABI架构不匹配

Lenovo Tab M8为arm架构设备，若部署时默认包含了x86等不兼容架构，会导致原生库加载失败崩溃。

• 解决：在Platforms/Android/<项目名>.csproj中添加指定ABI的配置：

  <PropertyGroup Condition="'$(TargetFramework)' == 'net8.0-android'">
      <AndroidSupportedAbis>arm64-v8a,armeabi-v7a</AndroidSupportedAbis>
  </PropertyGroup>
  

  执行清理（dotnet clean）、重建（dotnet build）后重新部署应用。

3. 设备上的.NET MAUI运行时损坏

调试部署时自动安装的.NET MAUI运行时可能因设备异常导致损坏，引发启动崩溃。

• 解决：
  1. 在Lenovo Tab M8的应用设置中，卸载所有包名包含com.microsoft.maui的调试运行时应用
  2. 重新在VS Code中部署当前MAUI项目，让系统自动重新安装适配的运行时

4. 设备硬件/系统兼容性问题

Lenovo Tab M8部分型号搭载联发科MT8766芯片，可能存在与.NET 8.0.405版本运行时的兼容性问题。

• 解决：
  1. 将设备系统更新到官方最新Android 13版本
  2. 尝试升级.NET SDK到8.0.406及以上补丁版本，重新构建部署

日志定位关键提示 #

从提供的logcat中搜索以下关键词，可快速定位崩溃根源：

• AndroidRuntime：查看崩溃的核心堆栈信息
• Caused by：定位崩溃的直接触发原因（如权限异常、库加载失败）
• UnsatisfiedLinkError：提示原生库不兼容，需检查ABI配置

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