# JMeter 踩坑记：CSV 数据文件设置只读取第一行的解决办法

最近在用 JMeter 做论坛注册并发测试时明明 CSV 里准备了多组用户名/密码可运行时所有虚拟用户都只用了第一行数据。排查后发现是“线程共享模式”的锅。特此记录希望帮到同样掉坑的朋友。---## 问题现象我的测试计划结构如下简化版- **线程组**5 个线程循环 1 次- **CSV 数据文件设置**- 文件名userlist.csv含 username,password 两列共 10 组数据- 变量名称username,password- 忽略首行True- 线程共享模式**当前线程**- **HTTP 请求**使用 ${username} 和 ${password} 发送注册请求运行后查看结果树发现 **所有 5 个请求都使用了 CSV 中第一组或第二组若忽略首行则实际为第一组有效数据的用户名/密码**并未按预期依次取不同行。---## 原因分析JMeter 的“CSV 数据文件设置”元件中**线程共享模式**决定了 CSV 文件的读取指针如何在多个线程间分配| 模式 | 行为 ||------|------|| **所有线程**共享 | 所有线程共用同一个指针按顺序依次读取线程 1 取第 1 行线程 2 取第 2 行…… || **当前线程** | 每个线程独立维护自己的指针且每个线程启动时指针都重置到文件开头。因此每个线程都从头开始读永远只读第一行或忽略首行后的第二行。 || **线程组** | 同一线程组内共享不同线程组独立较少用 |因为我的线程组有 5 个线程每个线程只执行一次且设为“当前线程”所以每个线程都独立地从文件开头读取自然全都使用了第一行数据。---## ✅ 解决方案将 **“线程共享模式”** 从 **“当前线程”** 改为 **“所有线程”**。修改后所有线程共享一个文件指针按顺序依次取数5 个线程便分别使用了 CSV 中的前 5 组数据。---## 操作步骤图文对照1. 在 JMeter 测试计划中找到 **“CSV 数据文件设置”** 元件通常在测试计划或线程组下。2. 在右侧属性面板中找到 **“线程共享模式”** 下拉框位置在“文件编码”下方“遇到文件结束符再次循环”上方。3. 将下拉值从 **“当前线程”** 改为 **“所有线程”**。4. 保存脚本重新运行测试观察结果树或聚合报告确认数据已按行分配。 若你的 CSV 有表头记得勾选“忽略首行”True这样变量名会正确映射到数据行。---## ⚠️ 补充说明与注意事项- **文件行数不足时**若线程数 CSV 有效行数且“遇到文件结束符停止线程” True则超出行数的线程会直接停止或报错。可改为 False 并开启“遇到文件结束符再次循环”来重复使用数据。- **循环多次时**若线程组设置循环次数 1且共享模式为“所有线程”则指针会持续下移直到文件末尾。若循环次数过多可能导致所有数据用完后指针越界需配合循环设置处理。- **编码问题**确保 CSV 文件的编码如 UTF-8与“文件编码”设置一致否则可能出现乱码。- **相对路径**建议使用相对路径如 ./test_data/userlist.csv而非绝对路径便于脚本迁移。---## 最终效果对比| 场景 | 线程共享模式 | 结果 ||------|-------------|------|| 5 线程1 次循环CSV 有 10 行数据 | **当前线程** | 5 个请求全部使用第 1 行数据 ❌ || 5 线程1 次循环CSV 有 10 行数据 | **所有线程** | 5 个请求分别使用第 1~5 行数据 ✅ |---## 心得总结JMeter 的 CSV 参数化非常强大但“线程共享模式”这个设置容易忽略。默认值通常是“所有线程”但某些旧版本或误操作可能改为“当前线程”。排查时请优先检查此项。如果你也遇到了类似“CSV 只读第一行”的问题按上述方法调整即可轻松解决。---**希望这篇文章能帮到正在学习 JMeter 的你** 如有疑问或不同见解欢迎在评论区交流讨论。---*本文基于 Apache JMeter 5.6.3 版本不同版本界面可能略有差异但核心概念一致。*