.NET MAUI应用发布Android时出现大量MSB3021错误求助

安全阿岳

2026-7-2

.NET MAUI发布Android版本出现MSB3021复制文件错误的解决方案

你的.NET MAUI应用调试时iOS和Android都正常，但发布Android时出现大量MSB3021错误，核心原因是发布过程中错误尝试复制iOS专属的Firebase资源文件，且目标路径不存在。以下是可行的解决步骤：

检查发布配置：打开Visual Studio的发布面板，确认当前发布目标仅为Android，未勾选iOS相关的目标平台。
调整项目文件引用：手动编辑.csproj文件，将iOS专属的NuGet包（如Xamarin.Firebase.iOS.Core）添加条件约束，仅在iOS目标下引用：
```
<ItemGroup Condition="'$(TargetFramework)' == 'net7.0-ios'">
  <PackageReference Include="Xamarin.Firebase.iOS.Core" Version="8.10.0.3" />
</ItemGroup>
```
清理NuGet缓存：执行命令清空本地NuGet缓存，再重新还原包：
```
dotnet nuget locals all --clear
dotnet restore
```
提升权限运行：以管理员身份启动Visual Studio，避免文件访问权限不足导致的路径创建失败。
更新开发工具：确保Visual Studio 2022及.NET MAUI工作负载为最新版本，安装所有可用更新修复已知的MSBuild问题。