Azure DevOps 2019：替换MSBuild为Script后构建代理异常切换问题

一、MSBuild@1任务与VS2022不兼容的原因 #

Azure DevOps 2019内置的MSBuild@1任务版本较低，无法自动识别VS2022安装的MSBuild路径。当任务中指定msbuildVersion: 'latest'时，它只会查找VS2019及更早版本的MSBuild，导致与VS2022环境不兼容，触发崩溃。

二、Script脚本导致代理切换的原因 #

MSBuild@1任务会自动向作业添加隐含需求（比如要求代理具备MSBuild组件），而Script任务没有这类隐含需求。尽管你在YAML中指定了代理名称，仍可能出现以下问题：

• 需求表达式语法细节：Azure DevOps中代理名称的属性是Agent.Name（首字母大写），部分旧版本对大小写敏感，可能导致需求匹配失败。
• 指定代理状态异常：My_Agent_Unity_1可能处于离线、未正确加入My_Pool池，或被其他作业占用，导致系统自动选择池内其他可用代理。
• 池内其他代理无冲突限制：当无法匹配指定代理时，系统会 fallback 到池内任意可用代理，而这些代理未安装Unity。

三、具体解决方案 #

1. 修复代理切换问题 #

• 修正需求表达式的大小写，并添加额外需求双重锁定：

  - job: unity
    pool:
      name: 'My_Pool'
      demands:
        - Agent.Name -equals My_Agent_Unity_1
        - Unity -exists  # 确保只有安装Unity的代理能被选中
  

• 检查代理状态：确认My_Agent_Unity_1在线、已注册到My_Pool池，且未被占用。
• 验证代理环境：在My_Agent_Unity_1上手动运行脚本中的vswhere命令，确认能正确获取VS2022的MSBuild路径，避免脚本执行失败引发间接问题。

2. 解决MSBuild与VS2022兼容问题 #

方案A：优化Script脚本（推荐）

修复脚本中的通配符问题（MSBuild不支持直接传入*.sln），改为遍历解决方案文件：

- script: |
    @echo off
    setlocal enabledelayedexpansion
    :: 仅获取VS2022的MSBuild路径
    for /f "usebackq tokens=*" %%i in (`"!ProgramFiles(x86)!\Microsoft Visual Studio\Installer\vswhere.exe" -version [17.0,18.0) -products * -requires Microsoft.Component.MSBuild -find MSBuild\**\Bin\MSBuild.exe`) do (
      set msbuild_exe=%%i
    )
    :: 遍历指定目录下的所有解决方案并构建
    for /r "$(Build.BinariesDirectory)$(unity.outputPath)" %%s in (*.sln) do (
      "!msbuild_exe!" "%%s" /p:Configuration=Release /p:Platform="ARM64" /p:AppxBundle=Always /p:AppxPackageDir=$(Build.ArtifactStagingDirectory)/AppPackages /t:rebuild
    )
  displayName: 'Build Appx Package via Script'

• 添加-version [17.0,18.0)参数，确保只匹配VS2022版本的MSBuild。
• 用for /r遍历解决方案文件，解决MSBuild不识别通配符的问题。

方案B：手动指定MSBuild路径给MSBuild@1任务

如果坚持使用MSBuild@1任务，可手动指定VS2022的MSBuild路径：

- task: MSBuild@1
  displayName: 'Build Appx Package - MSBuild@1'
  inputs:
    solution: '$(Build.BinariesDirectory)$(unity.outputPath)/YourSpecificSolution.sln'  # 替换为具体解决方案名称
    msbuildLocation: 'C:\Program Files\Microsoft Visual Studio\2022\Enterprise\MSBuild\Current\Bin\MSBuild.exe'  # 根据VS2022版本调整路径
    platform: 'ARM64'
    configuration: 'Release'
    msbuildArguments: '/p:AppxBundle=Always /p:AppxPackageDir=$(Build.ArtifactStagingDirectory)/AppPackages'

注意：此方案需提前确认代理上VS2022的安装路径，灵活性较差。

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