4. 用户自定义变量：User Defined Variables 与 User Parameters 的区别与使用场景

在 JMeter 参数化体系中，用户自定义变量（User Defined Variables, UDV） 和 用户参数（User Parameters） 是最基础、最常用的两种静态参数化元件。虽然它们都用于定义变量，但在作用域、初始化时机、线程隔离性以及适用场景上存在本质差异。错误混用会导致压测数据污染或参数化失效。

4.1 核心区别对比

4.2 作用域与初始化机制详解

理解两者的初始化时机是正确使用的关键。下面通过一张时序图展示 UDV 与 User Parameters 在测试执行过程中的变量赋值时刻。

4.3 使用场景与选择策略

根据压测目标的不同，选择正确的元件可以避免 80% 的参数化错误。以下按场景分类给出推荐方案：

• 场景一：环境配置（全局常量）
  • 示例：BASE_URL = https://api.example.com、TIMEOUT = 5000
  • 推荐元件：User Defined Variables
  • 理由：所有线程共享同一环境地址，无需隔离，且只需初始化一次。
• 场景二：多用户登录凭证（线程级数据）
  • 示例：线程1使用 user_001 / pass_001，线程2使用 user_002 / pass_002
  • 推荐元件：User Parameters
  • 理由：每个线程需要独立的凭证，且每次迭代可能需要轮换或更新。
• 场景三：混合使用（全局配置 + 线程数据）
  • 示例：全局域名 + 每个线程不同的设备ID
  • 推荐方案：UDV 定义全局变量 + User Parameters 定义线程变量
  • 理由：两者互补，UDV 提供公共配置，User Parameters 提供差异化数据。
• 场景四：函数动态生成（如时间戳、UUID）
  • 示例：${__time(yyyy-MM-dd)}、${__UUID()}
  • 推荐元件：User Parameters（若需要每次迭代不同）或 UDV（若只需固定一次）
  • 理由：User Parameters 每次迭代重新计算函数，UDV 仅在启动时计算一次。

4.4 常见误区与避坑指南

4.5 配置示例与代码片段

以下展示 UDV 与 User Parameters 的典型配置方式：

User Defined Variables 配置示例（测试计划级）：

名称: BASE_URL      值: https://api.example.com
名称: API_VERSION   值: v2
名称: DEFAULT_TIMEOUT 值: 3000
名称: ENABLE_CACHE  值: true

User Parameters 配置示例（线程组级，模拟 3 个用户）：

| 变量名      | 用户1          | 用户2          | 用户3          |
|-------------|----------------|----------------|----------------|
| username    | test_user_01   | test_user_02   | test_user_03   |
| password    | pwd_001        | pwd_002        | pwd_003        |
| device_id   | ${__UUID()}    | ${__UUID()}    | ${__UUID()}    |
| timestamp   | ${__time(,)}   | ${__time(,)}   | ${__time(,)}   |