Azure DevOps YAML管道工件下载及执行权限问题排查

一、解决「Unexpected value ''」下载工件错误 #

这个错误基本是因为publish或download步骤的参数配置有问题，比如工件名称留空、参数拼写错误。核心修正点：

• Build阶段的publish步骤必须明确指定非空的artifact名称，不能让它为空：

  - publish: $(Build.ArtifactStagingDirectory)/HelloWorld.exe
    artifact: HelloWorldArtifact  # 这里必须填有效的工件名
  

• Test阶段的download步骤要和Build阶段的工件名完全对应，避免空值参数：

  - download: current
    artifact: HelloWorldArtifact  # 和Build阶段的artifact名称一致
    path: $(System.DefaultWorkingDirectory)/test  # 可选，指定下载到的路径
  

二、解决执行文件权限拒绝错误 #

分两种代理环境处理：

Windows代理场景 #

Windows环境下，下载后的可执行文件可能被系统标记为「来自互联网」而锁定，需要先解锁：

- script: |
    Get-Item $(System.DefaultWorkingDirectory)/test/HelloWorld.exe | Unblock-File
    $(System.DefaultWorkingDirectory)/test/HelloWorld.exe
  displayName: "解锁并运行程序"

Linux/macOS代理场景 #

Linux/macOS系统默认不会给下载的文件添加执行权限，需要手动赋予：

- script: |
    chmod +x $(System.DefaultWorkingDirectory)/test/HelloWorld.exe
    $(System.DefaultWorkingDirectory)/test/HelloWorld.exe
  displayName: "添加权限并运行程序"

完整可用YAML示例 #

stages:
- stage: Build
  jobs:
  - job: BuildJob
    pool:
      vmImage: 'windows-latest' # 可根据编译需求换成ubuntu-latest/macOS-latest
    steps:
    - script: |
        # 替换成你的C++编译命令，比如MSBuild或g++
        g++ HelloWorld.cpp -o HelloWorld.exe
      displayName: "编译C++程序"
    - publish: $(System.DefaultWorkingDirectory)/HelloWorld.exe
      artifact: HelloWorldArtifact
      displayName: "发布工件"

- stage: Test
  jobs:
  - job: TestJob
    pool:
      vmImage: 'windows-latest' # 尽量和Build阶段的代理系统一致，避免跨系统兼容性问题
    steps:
    - download: current
      artifact: HelloWorldArtifact
      path: $(System.DefaultWorkingDirectory)/test
      displayName: "下载工件"
    # 下面根据代理系统选对应的步骤
    - script: |
        Get-Item $(System.DefaultWorkingDirectory)/test/HelloWorld.exe | Unblock-File
        $(System.DefaultWorkingDirectory)/test/HelloWorld.exe
      displayName: "解锁并运行程序"

额外提醒 #

• 尽量保证Build和Test阶段使用相同的代理系统，比如都是Windows或都是Linux，不然Windows的.exe文件在Linux上根本没法运行，会触发其他错误。
• 路径参数要适配代理系统，Windows用反斜杠，Linux/macOS用正斜杠，或者直接用Azure DevOps的内置变量自动适配路径格式。

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