如何通过Newman cli Companion将Azure DevOps变量传入Postman值？

安全阿岳

2026-9-28

问题排查与解决方案

修复大小写匹配问题
Azure DevOps变量名大小写敏感，你配置中出现了AAD-Password（DevOps库定义，大写P）和AAD-password（yml中引用，小写p）两个不一致的变量名，会导致变量解析为空，将两处变量名统一为完全一致的写法即可。

调整变量作用域配置
如果你Postman集合中的{{Password}}是环境变量而非全局变量，使用globalVars参数传值会无法生效，需要将参数替换为envVars：

task: NewmanPostman@4
  displayName: Run API Tests
  inputs:
    collectionFileSource: 'test.postman_collection.json'
    environment: 'test.postman_environment.json'            
    envVars: 'Password=$(AAD-Password)'

显式映射机密变量
存放在Azure DevOps库中的凭据属于机密变量，默认不会自动注入到任务执行上下文，需要在任务中显式声明环境变量映射才能正常解析：

task: NewmanPostman@4
  displayName: Run API Tests
  env:
    AAD_PASSWORD: $(AAD-Password)
  inputs:
    collectionFileSource: 'test.postman_collection.json'
    environment: 'test.postman_environment.json'            
    envVars: 'Password=$(AAD_PASSWORD)'

验证变量加载状态
可以在Newman任务前添加调试步骤，确认变量是否正常解析（不要直接打印明文机密变量，可通过判断是否为空、输出字符长度的方式验证），示例PowerShell调试步骤：
```
if ([string]::IsNullOrEmpty("$(AAD-Password)")) {
  Write-Host "变量未正常加载"
} else {
  Write-Host "变量已加载，长度：$("$(AAD-Password)".Length)"
}
```
替代传参方案
如果插件参数传参始终不生效，可以在管道中动态生成临时Postman环境变量文件，将需要的凭据写入文件后再传给Newman执行，绕开插件的变量解析逻辑。