如何在GitHub工作流中传递JMeter用户定义变量作为参数？

1. 确认GitHub工作流的inputs定义规范 #

先检查工作流文件中workflow_dispatch的inputs配置，必须明确将URL声明为必填字符串参数，示例如下：

on:
  workflow_dispatch:
    inputs:
      URL:
        description: '目标测试URL'
        required: true
        type: string

触发工作流时务必手动填入URL值；如果是自动触发（如push事件），要确保通过with字段传递对应参数。

2. 显式将GitHub参数传递给Azure负载测试任务 #

Azure负载测试官方Action（azure/load-testing）不会自动读取GitHub inputs或环境变量到JMeter脚本，必须手动配置参数传递：

方法一：直接在Action中映射JMeter变量 #

在工作流的Azure负载测试任务里，用parameters字段将GitHub inputs的URL值绑定到JMeter的URL变量：

- name: 执行Azure负载测试
  uses: azure/load-testing@v1
  with:
    loadTestConfigFile: './load-test-config.yml'
    resourceGroup: '你的资源组名称'
    loadTestResource: '你的负载测试资源名称'
    parameters: |
      URL=${{ github.event.inputs.URL }}

方法二：环境变量+测试配置文件映射 #

若习惯用环境变量传递，先在Action中设置环境变量，再在测试配置文件里关联到JMeter变量：
工作流片段：

- name: 执行Azure负载测试
  uses: azure/load-testing@v1
  env:
    TEST_TARGET_URL: ${{ github.event.inputs.URL }}
  with:
    loadTestConfigFile: './load-test-config.yml'
    resourceGroup: '你的资源组名称'
    loadTestResource: '你的负载测试资源名称'

然后在load-test-config.yml中添加参数映射：

testName: '业务接口负载测试'
testPlan: './your-test-script.jmx'
engineInstances: 1
parameters:
  - name: URL
    value: ${TEST_TARGET_URL}

3. 检查JMeter脚本的变量优先级 #

JMeter中外部传入的参数优先级高于User Defined Variables（UDV）的默认值，但要避免脚本内部覆盖URL变量：

• 清空UDV中URL的默认值，防止默认值覆盖传入参数
• 检查脚本中是否有后续元件（如JSR223脚本、其他UDV）修改了URL变量值

4. 日志排查定位问题 #

• 查看GitHub工作流的运行日志，找到Azure负载测试任务的输出，确认URL参数是否被正确传递
• 登录Azure门户，进入负载测试资源的运行详情页，在“参数”板块检查传入的URL值是否存在

5. 确保测试配置文件关联正确的JMeter脚本 #

在load-test-config.yml中必须正确指定JMeter脚本路径，否则参数无法传递到目标脚本：

testPlan: './path/to/your-script.jmx' # 确保路径与仓库实际位置一致

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