3. CSV Data Set Config 详解：文件格式、变量引用、线程共享模式、EOF处理

CSV Data Set Config 是 JMeter 参数化中使用频率最高的配置元件，适用于从外部 CSV 文件逐行读取测试数据。理解其文件格式规范、变量引用机制、线程共享模式以及文件结束（EOF）处理策略，是设计稳定、可复用的容量压测脚本的基础。

3.1 文件格式与编码规范

CSV Data Set Config 默认读取以逗号分隔的文本文件，但实际项目中文件格式往往存在差异。下表列出关键配置项及其推荐值：

3.2 变量引用机制

CSV Data Set Config 在每次迭代时从文件读取一行，将各列值赋值给 Variable Names 中定义的变量。这些变量在后续的 Sampler、断言、前置/后置处理器中通过 ${变量名} 语法引用。

变量作用域为当前线程组内的所有元件，但不同线程共享模式会影响变量值的分配方式。以下是一个典型的 CSV 文件与变量引用示例：

# users.csv（UTF-8 无 BOM）
username,password,role
test_user_01,pass123,admin
test_user_02,pass456,editor
test_user_03,pass789,viewer

在 CSV Data Set Config 中配置 Variable Names 为 username,password,role，并在 HTTP 请求中使用：

POST /api/login
Content-Type: application/json

{
  "username": "${username}",
  "password": "${password}",
  "role": "${role}"
}

3.3 线程共享模式

线程共享模式决定了多个线程如何从同一个 CSV 文件中读取数据。JMeter 提供四种模式，适用于不同的压测场景：

3.4 EOF 处理策略

EOF（End of File）处理是容量压测中极易被忽视但影响巨大的配置点。JMeter 提供两个互斥选项来控制文件读取完毕后的行为：

• Recycle on EOF = True：文件读取到最后一行后，自动回到第一行继续读取，实现数据循环使用。
• Stop thread on EOF = True：文件读取到最后一行后，当前线程立即停止执行（即使还有未完成的迭代次数）。

两个选项不能同时为 True，但可以同时为 False——此时线程在 EOF 后不再读取新数据，但继续执行剩余迭代，已读取的变量值保持不变。

3.5 实战配置示例

以下是一个完整的 CSV Data Set Config 配置示例，适用于 100 线程、持续 30 分钟的容量压测场景：

文件名：/data/test/users_100k.csv
文件编码：UTF-8
分隔符：,
变量名：uid,,device_id
允许带引号字段：True
线程共享模式：All threads
EOF 处理：Recycle on EOF = True, Stop thread on EOF = False

对应的 CSV 文件格式：

uid,,device_id
U100001,TKN_A1B2C3D4,DEV_001
U100002,TKN_E5F6G7H8,DEV_002
U100003,TKN_I9J0K1L2,DEV_003
...