Xamarin Forms项目ManifestMerger任务意外失败该如何解决？

DevOps 小满

2026-9-26

问题背景

更换新笔记本后安装了Visual Studio 2019，所用环境配置如下：

Microsoft Visual Studio Community 2019 Version 16.11.6（VisualStudio.16.Release/16.11.6+31829.152）
Microsoft .NET Framework Version 4.8.04084
安装版本：Community
ASP.NET and Web Tools 2019 16.11.94.52318
Azure App Service Tools v3.0.0 16.11.94.52318
C# Tools 3.11.0-4.21403.6+ae1fff344d46976624e68ae17164e0607ab68b10
Common Azure Tools 1.10
Extensibility Message Bus 1.2.6 (master@34d6af2)
IntelliCode Extension 1.0
Microsoft JVM Debugger 1.0
Microsoft MI-Based Debugger 1.0
Mono Debugging for Visual Studio 16.10.15 (552afdf)
NuGet Package Manager 5.11.0
ProjectServicesPackage Extension 1.0
TypeScript Tools 16.0.30526.2002
Visual Basic Tools 3.11.0-4.21403.6+ae1fff344d46976624e68ae17164e0607ab68b10
Visual F# Tools 16.11.0-beta.21514.6+b6c2c4f53ea3a08fa603ea93d6d2f808a62a21d1
Visual Studio Code Debug Adapter Host Package 1.0
VisualStudio.DeviceLog 1.0
VisualStudio.Foo 1.0
VisualStudio.Mac 1.0
Xamarin 16.11.000.190 d16-11@2391ed9
Xamarin Designer 16.11.0.47 (remotes/origin/d16-11@e0d612363)
Xamarin Templates 16.10.5 (355b57a)
Xamarin.Android SDK 12.0.0.3 (d16-11/f0e3c2d)
Xamarin.iOS and Xamarin.Mac SDK 15.0.0.8 (0796d78dc)

问题描述

在上述环境中新建Xamarin Forms项目后，编译时触发如下错误：

Severity    Code    Description Project File    Line    Suppression State
Error       The "ManifestMerger" task failed unexpectedly.
System.IO.FileNotFoundException: Could not find file 'C:\Users\skumbhar\source\repos\App4\App4\App4.Android\obj\Debug\110\android\AndroidManifest.xml.tmp'.
File name: 'C:\Users\skumbhar\source\repos\App4\App4\App4.Android\obj\Debug\110\android\AndroidManifest.xml.tmp'
   at System.IO.__Error.WinIOError(Int32 errorCode, String maybeFullPath)
   at System.IO.FileStream.Init(String path, FileMode mode, FileAccess access, Int32 rights, Boolean useRights, FileShare share, Int32 bufferSize, FileOptions options, SECURITY_ATTRIBUTES secAttrs, String msgPath, Boolean bFromProxy, Boolean useLongPath, Boolean checkHost)
   at System.IO.FileStream..ctor(String path, FileMode mode, FileAccess access, FileShare share, Int32 bufferSize)
   at System.Xml.XmlDownloadManager.GetStream(Uri uri, ICredentials credentials, IWebProxy proxy, RequestCachePolicy cachePolicy)
   at System.Xml.XmlUrlResolver.GetEntity(Uri absoluteUri, String role, Type ofObjectToReturn)
   at System.Xml.XmlTextReaderImpl.FinishInitUriString()
   at System.Xml.XmlTextReaderImpl..ctor(String uriStr, XmlReaderSettings settings, XmlParserContext context, XmlResolver uriResolver)
   at System.Xml.XmlReaderSettings.CreateReader(String inputUri, XmlParserContext inputContext)
   at System.Xml.XmlReader.Create(String inputUri, XmlReaderSettings settings, XmlParserContext inputContext)
   at System.Xml.Linq.XDocument.Load(String uri, LoadOptions options)
   at Xamarin.Android.Tasks.ManifestDocument..ctor(String templateFilename)
   at Xamarin.Android.Tasks.ManifestMerger.Execute()
   at Microsoft.Build.BackEnd.TaskExecutionHost.Microsoft.Build.BackEnd.ITaskExecutionHost.Execute()
   at Microsoft.Build.BackEnd.TaskBuilder.<ExecuteInstantiatedTask>d__26.MoveNext() App4.Android

已先后尝试清理并重建项目、修改VS 2019版本、重新安装VS 2019等操作，均无法解决该问题。

可行解决方法

手动清除项目缓存：关闭Visual Studio，找到项目根目录，分别删除Android项目下的bin、obj文件夹，以及解决方案根目录的.vs隐藏文件夹，重启Visual Studio重新加载项目后再编译。
检查AndroidManifest.xml合法性：打开Android项目Properties目录下的AndroidManifest.xml，确认文件没有语法错误、未闭合标签、非法字符，如果文件损坏可以替换为新建Xamarin.Android项目的默认配置，再按需调整参数。
调整Android目标框架版本：右键Android项目打开属性页，在「应用程序」选项卡中将「使用Android版本编译」的目标框架降低一个稳定版本，比如从Android 12调整为Android 11，保存后重新编译。
临时关闭安全防护：部分杀毒软件、系统受控文件夹访问功能会拦截Visual Studio生成临时文件，可临时关闭相关防护后再编译，确认是否为权限拦截导致的问题。
检查Windows用户名格式：如果当前Windows用户名包含中文、 emoji等非ASCII字符，会导致路径解析异常，可新建全英文用户名的Windows账号，在新账号环境下重新编译测试。
修复Xamarin组件：打开Visual Studio Installer，找到「使用.NET的移动开发」工作负载，先取消勾选Xamarin相关组件执行卸载，再重新勾选安装对应组件，完成后重启VS编译。

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