Azure Pipelines的yaml管道无法替换秘密变量$(cachix_token)如何解决？

解决方案 #

按照以下步骤排查修复即可：

1. 核对变量定义来源与引用方式
   • 如果变量是直接定义在管道UI的「变量」面板：
     • 检查你是否在YAML中显式清空了默认变量：如果你的YAML文件里存在空的variables: []配置，会导致UI定义的变量全部失效，删除该空配置，或者在variables段中显式声明引用该秘密变量：

       variables:
         cachix_token: $(cachix_token)
       

     • 触发管道运行时，点开「变量」选项卡，确认cachix_token变量名存在（值默认隐藏），如果看不到该变量，说明UI配置的变量作用域有误，需要编辑UI变量，将作用域设置为「对整个管道可用」。
   • 如果变量存储在变量组中：必须在YAML的variables段先引用对应变量组才能使用：

     variables:
     - group: 你的变量组名称
     

2. 排查作用域传递问题
   如果你的管道分为多个阶段、多个作业，秘密变量不会自动跨作业/跨阶段传递，需要在对应作业的env配置或者variables配置中显式引用该变量。
3. 验证变量有效性
   可以先添加临时调试步骤确认变量是否被正确识别：

- bash: echo "变量读取正常"
  env:
    TEST_VAR: $(cachix_token)
  condition: ne(variables['cachix_token'], '')

如果该步骤正常执行，说明变量已经被正确加载，回到你原有步骤即可正常使用；如果步骤被跳过，说明变量未被管道识别，回到前两步核对配置。
4. 额外注意事项
秘密变量仅支持运行时解析，不要使用编译时表达式${{ variables.cachix_token }}引用，必须用$(cachix_token)格式，且只能通过env字段传递给脚本，不要直接在脚本内容里直接写入$(cachix_token)，避免被自动脱敏替换为***。

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