Postman怎么用CSV批量提交表单_Postman数据驱动表单测试教程

落浩同学_5821

落浩同学_5821

2026-11-07

555人浏览

原创

CSV文件必须用UTF-8编码且无BOM,字段名须与{{}}内名称逐字符一致(大小写敏感、禁空格),Iterations应设为自动匹配行数,断言需用data.xxx而非pm.variables.get()。

postman怎么用csv批量提交表单_postman数据驱动表单测试教程

CSV文件必须用UTF-8编码,否则中文乱码或字段错位

Postman读取CSV时默认按字节解析,非UTF-8编码(比如Windows记事本默认的ANSI或GBK)会导致首行字段名识别失败,后续所有{{username}}引用都为空。常见现象是:Runner里Preview显示“undefined”,或控制台报ReferenceError: username is not defined。

实操建议:

  • 用VS Code、Notepad++或Sublime Text新建文本,手动选择“UTF-8”编码保存,后缀改为.csv
  • 不要用Excel直接另存为CSV——它默认用系统本地编码,且可能插入BOM头;如必须用Excel,先另存为CSV UTF-8 (comma delimited) (*.csv)格式(Excel 2016+才有)
  • 检查文件开头:用xxd data.csv | head -1确认无ef bb bf BOM字节;有则用sed -i '1s/^\xEF\xBB\xBF//' data.csv清除

变量名必须和CSV首行完全一致,大小写敏感且不能带空格

Postman把CSV第一行当作键名,逐字映射到{{key}}。若首行写的是user_name,但请求里写{{username}},变量就无法替换,body中会原样发送{{username}}字符串。

实操建议:

  • CSV首行只用英文、数字、下划线,避免中文、短横线、括号等特殊字符
  • 字段名与请求中{{}}内名称逐字符比对,推荐复制粘贴而非手打
  • 空值字段留空即可,不要填null或""——Postman会把它当字符串传过去

Collection Runner里Data文件上传后,Iterations要设为“自动”或匹配行数

如果CSV有5行数据(含首行),实际测试数据是4组,但把Iterations设成5,Postman会在第5轮尝试读取第5行数据——此时已越界,data.username为undefined,导致请求发空值或报错。

Postman 12.27.7
Postman 12.27.7

Postman 12.27.7 Windows x64 官方安装包,适用于 API 设计、调试、测试与协作。该系列包含 Enterprise 云端性能测试静态 IP 出口能力,以及接口规范标签管理改进,适合受限网络测试与规范资源组织场景。

下载

实操建议:

  • 在Runner界面勾选Data file iteration模式(默认开启),Postman会自动按CSV行数执行,无需手动填Iterations
  • 若需重复跑多轮(比如每组数据跑3次),用-n 3配合Newman命令行,而不是在GUI里硬调Iterations
  • 上传后点Preview按钮,确认显示的数据行数与你预期一致

断言里访问CSV字段要用data.xxx,不是pm.variables.get("xxx")

很多人在Tests里写pm.expect(pm.response.json().code).to.eql(pm.variables.get("expected_code")),结果始终失败——因为CSV变量不进pm.variables,而是在运行时注入全局data对象。

实操建议:

  • 断言中直接用data.expected_code,例如:pm.expect(pm.response.json().code).to.eql(data.expected_code)
  • 注意data是每轮独立对象,不可跨轮修改;如需跨轮累计状态,改用pm.globals.set()
  • 调试时在Tests里加console.log(data),看Console输出确认字段是否存在

CSV参数化真正卡住人的地方,往往不是语法,而是编码、字段名肉眼不可见的差异(比如全角空格)、或者误以为data变量能被脚本修改。跑不通时,先看Preview是否正常加载,再看Console里data打印结果,比反复改脚本更快。

相关文章

驱动精灵
驱动精灵

驱动精灵基于驱动之家十余年的专业数据积累,驱动支持度高,已经为数亿用户解决了各种电脑驱动问题、系统故障,是目前有效的驱动软件,有需要的小伙伴快来保存下载体验吧!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
软件测试常用工具
软件测试常用工具

软件测试常用工具有Selenium、JUnit、Appium、JMeter、LoadRunner、Postman、TestNG、LoadUI、SoapUI、Cucumber和Robot Framework等等。测试人员可以根据具体的测试需求和技术栈选择适合的工具,提高测试效率和准确性 。

2023.10.13

5090

8

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

2026.11.06

0

12

Postman请求头Headers怎么设置
Postman请求头Headers怎么设置

围绕Postman HTTP请求头配置展开,讲解Headers选项的具体使用方式,包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法,帮助用户解决接口调试过程中遇到的请求头配置问题。

2026.11.06

0

13

Postman接口请求发送教程
Postman接口请求发送教程

详细介绍Postman接口请求的创建与发送方法,涵盖GET和POST请求、URL配置、请求参数、Headers请求头、Body请求体设置以及响应结果查看,帮助用户掌握Postman接口请求的完整操作流程。

2026.11.06

0

10

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

2026.11.05

20

12

DBeaver安全防护教程大全
DBeaver安全防护教程大全

DBeaver安全防护专题,围绕数据库连接安全、账号密码保护和访问权限管理展开,整理SSL/TLS加密连接、SSH隧道、数据库凭据保存及证书验证等配置方法,同时介绍敏感信息保护、远程连接风险和高权限账号使用等注意事项,帮助用户提高数据库日常管理的安全性。

2026.11.05

20

12

DBeaver连接创建与配置教程
DBeaver连接创建与配置教程

本专题聚焦DBeaver数据库连接配置与管理,覆盖从新建连接、选择数据库类型到填写连接参数和验证连接的完整流程。针对MySQL、PostgreSQL、SQL Server等常见数据库,整理相应的连接设置方法,并提供驱动缺失、认证失败和连接异常等问题的排查方向。

2026.11.04

20

16

XORM框架结构体映射与表结构同步
XORM框架结构体映射与表结构同步

本专题围绕XORM框架的结构体映射展开,说明表名与字段的命名策略、xorm标签常用属性、主键自增与时间字段自动填充,并演示Sync2自动建表、增量字段升级、索引声明与反向生成结构体的完整流程。

2026.11.04

20

15

XORM框架安装配置与数据库连接
XORM框架安装配置与数据库连接

本专题聚焦XORM框架的配置与连接环节,拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择,讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式,并补充容器与兼容数据库的适配经验。

2026.11.04

20

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Postman Native Git工作流指南
Postman Native Git工作流指南

共0课时 | 0人学习

Postman Vault密钥管理指南
Postman Vault密钥管理指南

共0课时 | 0人学习

Postman集合运行器使用指南
Postman集合运行器使用指南

共0课时 | 0人学习