Azure Pipeline矩阵策略下结合模板的变量扩展异常问题

Azure Pipelines的表达式存在硬时机边界：

• ${{ }} 属于模板编译期表达式，在流水线完成配置解析、矩阵策略生成前就会完成全部展开，此时矩阵定义的Documentation/Language变量还未注入上下文，作为参数传入模板时只会是空值，最终拼接出的任务名退化为__params，后续的输出变量引用完全失效，直接导致下游发布任务拿不到必填的制品名参数报错。
• $( ) 属于运行时表达式，才会在矩阵分支的实际作业启动时，读取矩阵注入的变量值。

关于“调整表达式适配矩阵取值”的结论 #

不存在可直接修改表达式语法实现适配的方案：2020本地版Azure DevOps的模板参数机制，要求所有传入参数必须是编译期可确定的静态值，矩阵变量、CI内置变量这类运行时动态值天然无法满足模板参数的输入要求，这是编译逻辑的硬限制，没有语法层面的调整空间。

简易落地规避方案 #

核心思路是绕开“运行时变量转模板参数”的错误传参链路，借助矩阵作业的上下文隔离特性，用最小改动实现模板复用，完全兼容原有固定参数调用的场景。

方案一：矩阵场景的最简修改 #

直接修改create-and-upload-docu.yml模板，把原有依赖编译期参数的逻辑，替换为运行时变量读取，同时借助矩阵作业的天然隔离性简化任务名规则：

steps:
- script: |
    # 直接用运行时语法读取矩阵注入的变量值
    ARCHIVERELPATH=$(Documentation)-$(Language).zip
    ARCHIVEDIR=$(echo -n $(ArchiveBaseDir) | sed -e 's@/$@@')/$(Documentation)/$(Language)
    echo "##vso[task.setvariable variable=archiveRelPath;isOutput=true]$ARCHIVERELPATH"
    echo "##vso[task.setvariable variable=archiveDir;isOutput=true]$ARCHIVEDIR"
  # 用固定任务名，不做动态拼接
  name: DocuParams

- task: DeleteFiles@1
  inputs:
    Contents: '$(Build.ArtifactStagingDirectory)/$(DocuParams.archiveRelPath)'

对应调用端的矩阵配置，把所有需要用到的变量（包括原模板需要传入的ArchiveBaseDir）直接定义在每个矩阵分支下，不再给模板传参数：

jobs:
  - job: Documentation_CI
    displayName: "Docu CI"
    timeoutInMinutes: 30
    strategy:
      matrix:
        main_en_US:
          Documentation: main
          Language: en_US
          ArchiveBaseDir: '$(Ws)/build/'
        main_de_AT:
          Documentation: main
          Language: de_AT
          ArchiveBaseDir: '$(Ws)/build/'
    steps:
      - checkout: self
      # 直接引用模板，无需传参
      - template: create-and-upload-docu.yml@templates

该方案无冲突的原理：矩阵策略生成的每个分支是完全独立的作业上下文，固定名称的DocuParams任务只会在当前作业范围内存在一次，天然满足输出变量的引用唯一性要求，完全不需要手动拼接文档名_语言名做标识。

方案二：兼容原有固定参数调用的通用修改 #

如果需要保留模板对“非矩阵场景、传固定参数调用”的支持，可以给模板加空值兼容逻辑，同时适配两类场景：

parameters:
- name: Documentation
  type: string
  default: ''
- name: Language
  type: string
  default: ''
- name: ArchiveBaseDir
  type: string
  default: ''

steps:
- script: |
    # 优先使用编译期传入的模板参数，空值则 fallback 到运行时矩阵变量
    DOCU=${{ parameters.Documentation }}
    LANG=${{ parameters.Language }}
    BASEDIR=${{ parameters.ArchiveBaseDir }}
    if [ -z "$DOCU" ]; then DOCU=$(Documentation); fi
    if [ -z "$LANG" ]; then LANG=$(Language); fi
    if [ -z "$BASEDIR" ]; then BASEDIR=$(ArchiveBaseDir); fi

    ARCHIVERELPATH=${DOCU}-${LANG}.zip
    ARCHIVEDIR=$(echo -n $BASEDIR | sed -e 's@/$@@')/${DOCU}/${LANG}
    echo "##vso[task.setvariable variable=archiveRelPath;isOutput=true]$ARCHIVERELPATH"
    echo "##vso[task.setvariable variable=archiveDir;isOutput=true]$ARCHIVEDIR"
  name: DocuParams

- task: DeleteFiles@1
  inputs:
    Contents: '$(Build.ArtifactStagingDirectory)/$(DocuParams.archiveRelPath)'

这种模式下：

• 原有固定参数的调用逻辑完全不受影响，传参后会优先使用编译期确定的参数值
• 矩阵场景下不传模板参数时，脚本会自动读取运行时注入的矩阵变量，不会出现空值问题

2020本地版适配注意事项 #

• 不要尝试把运行时表达式写到任务名的位置：Azure Pipelines的任务名是编译期静态解析的，写在任务名位置的$(xxx)不会生效，只会生成无效名称
• 不要尝试用动态模板语法生成唯一任务名：2020本地版对each类动态生成步骤的支持不完善，稳定性差，用固定任务名+作业上下文隔离的方案是最稳妥的选择

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