.NET MAUI Android发布版本构建报错（MSB6006），求解决方法

• 查看完整诊断日志：默认构建日志信息有限，在命令行执行dotnet build -c Release -f net7.0-android -v diag生成诊断级日志，重点搜索java.exe相关的详细报错输出，通常能定位到具体触发失败的原因（比如资源冲突、依赖缺失、混淆规则错误等）。

• 排查NuGet依赖问题：

  • 用dotnet list package --outdated检查项目中过时的NuGet包，尤其是Android相关依赖（如Microsoft.Maui.、Xamarin.Android.），统一更新到与.NET 7兼容的稳定版本。
  • 删除本地NuGet缓存（路径为%userprofile%\.nuget\packages），重新执行dotnet restore还原依赖，避免缓存损坏导致的异常。

• 清理构建缓存：删除项目目录下的bin、obj文件夹，同时清理VS相关缓存（路径为%LOCALAPPDATA%\Microsoft\VisualStudio\17.0_*\ComponentModelCache，需替换为对应VS版本号），之后重新尝试构建。

• 检查Android资源合规性：

  • 确保所有资源文件名（布局、图片、字符串等）符合Android规范：仅使用小写字母、数字、下划线，禁止大写或特殊字符。
  • 排查重复资源：搜索诊断日志中的duplicate resource关键词，确认是否存在不同目录或第三方库中的同名资源冲突。

• 验证R8/ProGuard配置：发布版本默认启用R8代码混淆，若混淆规则配置不当会导致Java编译失败。可临时在csproj中添加<AndroidR8Enabled>false</AndroidR8Enabled>关闭R8，若构建成功，再逐步添加需要保留的类、方法对应的ProGuard规则。

• 确认JDK版本兼容性：确保使用OpenJDK 11（.NET MAUI官方推荐版本），在VS的「工具-选项-Android设置」中检查JDK路径是否正确，或通过java -version命令验证环境变量JAVA_HOME指向的版本。

• 排查原生代码问题：

  • 检查自定义Android渲染器、原生绑定代码是否存在API调用错误，比如使用了已废弃的Android API，或未处理不同API版本的兼容性逻辑。
  • 临时启用发布模式调试：在csproj中设置<AndroidEnableProfiledAot>false</AndroidEnableProfiledAot>和<DebugType>portable</DebugType>，连接设备调试发布版本，查看是否有运行时错误触发构建失败。

• 最小化项目定位问题：创建一个空的.NET MAUI项目，逐步添加原项目的页面、依赖和资源，每添加一部分就尝试构建发布版本，定位到具体导致失败的模块或代码。

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