Azure Pipelines中File Creator任务无法解析变量组问题

我在Azure DevOps维护一个为其他前端项目构建发布端到端测试的项目，目前正从传统GUI任务组管道迁移到YAML管道，但在使用变量组中的变量时遇到问题。变量组已授权给管道，管道验证通过，但运行测试任务时变量未被解析，导致失败。我希望避免在YAML中硬编码变量，想确认变量引用是否正确。

原有配置 #

• 构建并发布工件的构建管道（YAML版本运行正常）
• 包含下载工件、npm install、File Creator任务（GUI中直接定义变量）创建.env文件、npm运行测试的构建管道
• 独立的发布流程

当前配置 #

• 用于文件创建和测试运行的YAML模板（替代任务组供其他项目复用）
• 构建并发布的YAML文件，构建工件后引入上述模板

多阶段YAML管道代码 #

variables:
- group: End2EndV3
trigger:
  branches:
    include:
    - refs/heads/main
stages:
- stage: BuildArtifact
  jobs:
  - job: Job_1
    displayName: Agent job 1
    pool:
      vmImage: windows-2019
    steps:
    - checkout: self
      fetchDepth: 1
    - task: NodeTool@0
      displayName: Use Node 10.x
      inputs:
        versionSpec: 10.x
    - task: CopyFiles@2
      displayName: 'Copy Files to: $(Build.ArtifactStagingDirectory)'
      inputs:
        TargetFolder: $(Build.ArtifactStagingDirectory)
    - task: PublishBuildArtifacts@1
      displayName: 'Publish Artifact: MyArtifact'
      inputs:
        ArtifactName: MyArtifact
- stage: RunTests
  jobs:
  - job: RunTests
    steps:
    - template: template-test-release.yml
    ...

问题YAML模板代码 #

steps:
- task: eliostruyf.build-task.custom-build-task.file-creator@6
  displayName: 'Create cypress.env.json'
  inputs:
    filepath: 'somefilepath/MyArtifact/cypress.env.json'
    filecontent: |
     {
       "myVariable": "$(myVariableFromLibraryValue)",
     }
    fileoverwrite: true
    verbose: true

- task: Npm@1
  displayName: 'npm ci install'
  inputs:
    command: ci
    workingDir: '$(System.DefaultWorkingDirectory)/somefilepath/MyArtifact'
    verbose: false

- task: Npm@1
  displayName: 'npm run tests'
  inputs:
    command: custom
    workingDir: '$(System.DefaultWorkingDirectory)/somefilepath/MyArtifact'
    verbose: false
    customCommand: 'run cy:run:tests'

- task: PublishTestResults@2
  displayName: 'Publish Test Results *-test-output.xml'
  inputs:
    testResultsFiles: '*-test-output.xml'
    searchFolder: '$(System.DefaultWorkingDirectory)/somefilepath/MyArtifact/cypress/results'
    mergeTestResults: true

排查与解决方案 #

1. 确认变量组与变量名称匹配 #

根级别引用变量组End2EndV3的写法正确，所有阶段理论上都能访问变量。重点检查：

• 变量组中是否存在myVariableFromLibraryValue这个变量，名称完全匹配（Azure DevOps变量默认大小写敏感）。
• 如果是机密变量，需确保变量组已授权给管道，且管道允许使用机密变量。

2. 补加工件下载步骤 #

你的RunTests阶段没有下载之前发布的MyArtifact，会导致后续任务找不到目标文件，也可能让变量解析问题被掩盖。需要在模板开头添加下载任务：

- task: DownloadBuildArtifacts@0
  displayName: 'Download Build Artifacts'
  inputs:
    buildType: 'current'
    downloadType: 'single'
    artifactName: 'MyArtifact'
    downloadPath: '$(System.DefaultWorkingDirectory)/somefilepath'

3. 验证变量是否被正确解析 #

在模板中添加打印变量的任务，确认变量是否被传递：

- task: PowerShell@2
  displayName: 'Check Variable Value'
  inputs:
    targetType: 'inline'
    script: |
      Write-Host "myVariableFromLibraryValue: $(myVariableFromLibraryValue)"

如果输出变量值，说明变量解析正常，问题出在File Creator任务或测试逻辑；如果输出$(myVariableFromLibraryValue)，则说明变量未被正确传递，需检查变量组授权或作用域。

4. 机密变量的特殊处理 #

如果myVariableFromLibraryValue是机密变量，需在任务中显式传递：

- task: eliostruyf.build-task.custom-build-task.file-creator@6
  displayName: 'Create cypress.env.json'
  inputs:
    filepath: 'somefilepath/MyArtifact/cypress.env.json'
    filecontent: |
     {
       "myVariable": "$(myVariableFromLibraryValue)",
     }
  env:
    myVariableFromLibraryValue: $(myVariableFromLibraryValue)
  fileoverwrite: true
  verbose: true

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