.NET 7.0 MAUI Blazor调试正常但发布版启动闪退求助

先解决日志捕获问题（核心前提） #

• 用Android原生日志工具抓取崩溃信息，连接设备后执行命令：
  adb logcat -s Maui:V BlazorWebView:V AndroidRuntime:E
  启动闪退时会输出详细的崩溃堆栈，这是定位问题最直接的方式。
• 检查Serilog发布版配置：确保发布模式下日志输出到可访问路径，同时在AndroidManifest.xml添加文件读写权限（适配API33）：

  <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="32" />
  <uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
  

  并确认Serilog配置中指定了文件输出路径，比如：

  Log.Logger = new LoggerConfiguration()
      .WriteTo.File(Path.Combine(Environment.GetExternalStoragePublicDirectory(Environment.DirectoryDocuments).AbsolutePath, "app.log"))
      .CreateLogger();
  

常见闪退原因及修复方案 #

1. R8代码混淆误删依赖类 #

MAUI发布默认开启R8混淆，可能破坏Blazor或自定义代码的依赖关系：

• 临时关闭混淆测试：在项目csproj中添加：

  <AndroidEnableProguard>false</AndroidEnableProguard>
  <AndroidEnableR8>false</AndroidEnableR8>
  

  若关闭后不再闪退，说明是混淆问题，需在Platforms/Android/proguard.cfg中添加必要的保留规则：

  -keep class Microsoft.AspNetCore.Components.** { *; }
  -keep class Microsoft.Maui.Controls.WebView.** { *; }
  -keep class [你的应用命名空间].** { *; }
  -keepattributes *Annotation*, Signature
  

2. 发布版权限缺失 #

调试版会自动授予部分权限，但发布版需手动声明：

• 确保AndroidManifest.xml包含Blazor运行必需的权限：

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

• 若应用涉及文件、相机等功能，需补充对应权限并在代码中动态申请（API33+权限适配需注意）。

3. Blazor资源打包异常 #

wwwroot资源未正确打包到发布版中：

• 检查csproj中资源配置，确保wwwroot文件被标记为MauiAsset：

  <MauiAsset Include="wwwroot/**" LogicalName="wwwroot/[RecursiveDir]"/>
  

• 确认所有wwwroot下的静态文件（js/css/html）的“复制到输出目录”设置为“始终复制”或“保留最新版本”。

4. 签名配置错误 #

• 确保发布用的签名文件（.keystore/.jks）的别名、密码正确，且Google Play Console中的应用签名与本地签名一致（若用Google Play签名）。
• 发布时勾选“启用V2签名”，Android 11+设备要求V2及以上签名版本。

5. API33适配问题 #

API33新增了权限和行为限制：

• 若应用使用通知功能，需动态申请POST_NOTIFICATIONS权限，发布版需处理用户拒绝权限的场景。
• 避免直接访问外部存储根目录，改用MediaStore或应用私有目录存储文件。

验证流程 #

1. 先构建关闭混淆的发布APK，安装到真机测试，确认是否闪退。
2. 用adb logcat抓取崩溃日志，根据堆栈信息定位具体问题点。
3. 针对定位出的问题逐一修复后，重新构建发布版验证。

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