Azure DevOps构建管道突发无法构建，寻求排查解决方案

问题背景 #

Azure DevOps构建管道未修改YAML配置，但在执行解决方案还原与构建步骤时失败。核心错误为NuGet解析SLN文件时抛出"调用目标异常"。已确认Accuro3S.Algorithms.sln文件本身无异常，重新生成Personal Access Token（PAT）无效，且在构建代理机器上手动执行还原操作可成功完成。

错误日志 #

The nuget command failed with exit code(1) and error(System.AggregateException: One or more errors occurred. ---> NuGet.CommandLine.CommandLineException: Error parsing solution file at C:\agent_work\1\s\Accuro3S.Algorithms.sln: Exception has been thrown by the target of an invocation. at NuGet.CommandLine.MsBuildUtility.GetAllProjectFileNamesWithMsBuild(String solutionFile, String msbuildPath) at NuGet.CommandLine.RestoreCommand.ProcessSolutionFile(String solutionFileFullPath, PackageRestoreInputs restoreInputs) at NuGet.CommandLine.RestoreCommand.d__37.MoveNext() --- End of stack trace from previous location where exception was thrown --- at System.Runtime.ExceptionServices.ExceptionDispatchInfo.Throw() at System.Runtime.CompilerServices.TaskAwaiter.HandleNonSuccessAndDebuggerNotification(Task task) at NuGet.CommandLine.RestoreCommand.d__30.MoveNext() --- End of inner exception stack trace --- at System.Threading.Tasks.Task.ThrowIfExceptional(Boolean includeTaskCanceledExceptions) at System.Threading.Tasks.Task.Wait(Int32 millisecondsTimeout, CancellationToken cancellationToken) at NuGet.CommandLine.Command.Execute() at NuGet.CommandLine.Program.MainCore(String workingDirectory, String[] args) ---> (Inner Exception #0) NuGet.CommandLine.CommandLineException: Error parsing solution file at C:\agent_work\1\s\Accuro3S.Algorithms.sln: Exception has been thrown by the target of an invocation. at NuGet.CommandLine.MsBuildUtility.GetAllProjectFileNamesWithMsBuild(String solutionFile, String msbuildPath) at NuGet.CommandLine.RestoreCommand.ProcessSolutionFile(String solutionFileFullPath, PackageRestoreInputs restoreInputs) at NuGet.CommandLine.RestoreCommand.d__37.MoveNext() --- End of stack trace from previous location where exception was thrown --- at System.Runtime.ExceptionServices.ExceptionDispatchInfo.Throw() at System.Runtime.CompilerServices.TaskAwaiter.HandleNonSuccessAndDebuggerNotification(Task task) at NuGet.CommandLine.RestoreCommand.d__30.MoveNext()<---)

排查建议 #

• 核对NuGet/MSBuild版本差异：手动执行使用的本地NuGet/MSBuild版本可能与管道任务指定的版本不一致。在管道中添加NuGetToolInstaller任务，显式指定与手动执行时相同的NuGet版本；同时确认MSBuild任务的版本（如使用vsversion参数）与本地环境匹配。
• 验证工作目录文件完整性：管道拉取的代码可能存在文件缺失或路径异常。在管道中添加步骤执行dir C:\agent_work\1\s命令，输出工作目录结构，与本地代码目录对比，确保SLN引用的所有项目文件存在，且路径无大小写或格式问题。
• 检查环境变量差异：管道运行在代理服务账户环境下，与手动执行的用户环境变量可能存在差异。添加步骤执行set命令输出所有环境变量，重点对比MSBUILD_PATH、NuGet相关变量，确认管道环境配置与本地一致。
• 替换还原方式为MSBuild：尝试将管道中的NuGet Restore任务替换为MSBuild任务，使用/restore参数直接还原并构建（如msbuild Accuro3S.Algorithms.sln /restore /t:Build），绕过NuGet对SLN的解析逻辑。
• 清理代理缓存与工作目录：代理工作目录的旧缓存可能导致冲突。在管道开始时添加步骤执行nuget locals all -clear清理NuGet缓存，或手动删除代理机器上C:\agent_work\1\s和C:\agent_work\1\a目录下的文件，再重新运行管道。
• 确认代理账户权限与NuGet配置：虽然手动执行成功，但管道运行的服务账户可能存在权限限制。检查代理账户是否能访问所有所需的NuGet源（包括私有源），并对比代理机器上%AppData%\NuGet\NuGet.Config与管道使用的NuGet配置文件是否一致。

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