如何通过Jenkins向JMeter传递自定义变量文件适配多环境测试

核心思路 #

把环境差异化配置从jmx脚本里完全剥离，按环境拆分独立配置文件，构建时通过Jenkins参数选择目标环境，动态加载对应配置传给JMeter，实现单脚本适配多环境。

具体操作步骤 #

• 第一步：拆分环境独立配置
  不要把环境相关的域名、账号、数据库地址这类值写死在jmx的用户自定义变量里。单独为每个测试环境创建properties格式的配置文件，比如test_env.properties、pre_env.properties，文件里按变量名=变量值的格式写配置，例：

  base.api.url=https://test-api.xxx.com
  test.account=test01
  db.port=3306
  

  把这些配置文件和jmx脚本一起存到代码仓库的固定目录，比如/jmeter/env_configs/，保证Jenkins拉取代码时能拿到所有环境的配置。
• 第二步：Jenkins任务配置参数化构建
  新建/编辑JMeter执行任务时，开启「参数化构建过程」，添加选项类型的构建参数，参数名设为TARGET_ENV，可选值填你需要的两个环境标识（比如test、pre），后续构建时手动选择要执行的目标环境即可。
• 第三步：构建时动态传参给JMeter
  两种落地方式选一种就行：
  1. 直接通过JMeter命令行加载配置文件（最推荐，改动最小）
     把jmx脚本里原来硬编码的环境相关变量，全部替换成JMeter属性函数取值的形式：${__P(变量名, 兜底默认值)}，比如原来写死的接口地址，替换成${__P(base.api.url, https://default.xxx.com)}。
     构建步骤里执行JMeter的命令用-q参数加载选中环境的配置文件即可，示例命令：

     jmeter -n -t ./your_script.jmx \
     -q ./env_configs/${TARGET_ENV}_env.properties \
     -l ./${TARGET_ENV}_result.jtl \
     -e -o ./${TARGET_ENV}_report
     

     JMeter启动时会自动读取指定properties文件里的所有键值对，替换脚本里对应属性占位符。
  2. 环境变量注入逐个传参
     如果不想改动原有jmx的变量结构，可以在Jenkins构建步骤里添加「注入环境变量」环节，根据选中的TARGET_ENV读取对应配置文件，把所有配置项注入为Jenkins构建期的环境变量，再在JMeter启动命令里通过-J参数逐个传递，例：jmeter -n -t your_script.jmx -Jbase.api.url=${BASE_API_URL} -Jtest.account=${TEST_ACCOUNT}，脚本里同样用__P函数接收参数即可。

注意事项 #

• 数据库密码、接口密钥这类敏感配置不要直接明文存在配置文件里提交仓库，可以配合Jenkins的凭据管理功能存储敏感值，构建时动态替换配置文件里的占位符，避免信息泄露。
• 如果是通过Jenkins Performance插件执行JMeter，不需要手写shell命令，直接在插件的JMeter属性配置栏填入-q ${WORKSPACE}/env_configs/${TARGET_ENV}_env.properties就能实现相同的配置加载效果。

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