Bitbucket Pipeline自定义变量在自托管机器中值为空

问题根源 #

Bitbucket Pipelines在Docker容器（类Unix环境）中默认使用Bash，变量引用采用${var}格式；但Windows自托管Runner默认使用PowerShell，变量引用语法为$var，原脚本中的类Unix变量语法在PowerShell环境下无法正确解析，导致变量值为空。

修复步骤 #

1. 修改Pipeline脚本的变量引用方式
   将自定义变量的引用从${变量名}改为PowerShell兼容的$变量名，同时为避免参数含空格时被拆分，给每个参数加上双引号：

   script:
     - cd TestAutomation
     - .\Example1.bat "$testngFile" "$browser" "$environment" "$tags"
   

2. 验证变量传递状态
   在执行bat文件前添加变量打印步骤，确认变量是否被正确接收：

   script:
     - cd TestAutomation
     - Write-Host "Received variables: testngFile=$testngFile, browser=$browser, environment=$environment, tags=$tags"
     - .\Example1.bat "$testngFile" "$browser" "$environment" "$tags"
   

3. 优化bat文件的参数处理
   如果传递的参数包含引号，bat文件中可以用%~n语法去掉引号，避免Maven解析出错：

   mvn clean test -Dproject.testngFile=%~1 -Dbrowser.name=%~2 -Dproject.environment=%~3 -Dcucumber.filter.tags=@%~4
   

额外注意事项 #

• 确保自托管Windows Runner的Bitbucket Pipelines Agent为最新版本，旧版本可能存在变量传递兼容性问题。
• 检查Runner进程权限，确保其能正常读取Bitbucket传递的环境变量。

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