Ubuntu 下 Postman 测试运行器使用指南
一 安装与启动 Postman
- 使用 Snap 安装(推荐):
- 更新并安装 Snap:sudo apt update && sudo apt install snapd
- 安装 Postman:sudo snap install postman
- 启动:在应用菜单搜索 Postman 或终端执行 postman
- 手动安装(下载解压方式):
- 下载:wget https://dl.pstmn.io/download/latest/linux64 -O postman.tar.gz
- 解压:sudo tar -xzf postman.tar.gz -C /opt
- 启动:/opt/Postman/Postman
- 可选快捷方式(/usr/share/applications/postman.desktop):
- Exec=/opt/Postman/Postman
- Icon=/opt/Postman/app/resources/app/assets/icon.png
- 赋予执行权限:sudo chmod +x /usr/share/applications/postman.desktop
以上两种方式均可在 Ubuntu 上正常使用 Postman 桌面客户端。
二 在图形界面使用 Runner
- 创建集合与请求:在左侧 Collections 中新建集合,添加需要批量运行的 HTTP 请求,并在请求的 Tests 标签内编写 JavaScript 断言(如检查状态码、响应体字段等)。
- 打开 Runner:在集合侧边或底部工具栏点击 Runner 按钮,将目标集合拖入运行面板。
- 配置运行参数:
- Iterations:迭代次数
- Delay:请求间延迟(ms)
- Data:选择数据文件(如 CSV/JSON)进行数据驱动测试
- 运行与查看结果:点击 Run 执行,在 Runner 结果面板查看每个请求的 状态码、响应时间、断言结果 等,便于批量回归与定位问题。
三 命令行自动化运行 Newman
- 安装 Newman(Postman 命令行工具):npm install -g newman
- 导出资源:在 Postman 中将 集合 Collection 与 环境 Environment 导出为 JSON 文件(例如 collection.json、environment.json)。
- 运行测试:
- 基本:newman run collection.json
- 指定环境:newman run collection.json --environment environment.json
- 常用选项:
- 生成报告:–reporters cli,html,json
- 报告文件:–reporter-html-export report.html
- 迭代与数据:–iteration-count 10 --data data.csv
- 持续集成示例(CI):
- newman run collection.json --environment environment.json --reporters cli,html --reporter-html-export report.html
Newman 适合在 Ubuntu 服务器、CI/CD 流水线 中无界面批量执行与生成报告。
四 常见问题与实用建议
- 运行器看不到请求或变量:确认已将请求保存到 集合,并在运行配置中选择正确的 环境 Environment。
- 数据驱动不生效:确保数据文件为 CSV/JSON 且字段名与脚本中引用一致;在 Runner 的 Data 选项中正确选择文件。
- 报告导出:图形界面 Runner 支持查看结果;如需 HTML/JSON 报告,建议使用 Newman 的 reporters 导出。
- 命令行找不到 newman:确认已全局安装(npm install -g newman),或使用 npx newman 运行。
- 环境与授权:在 CI 中使用 Newman 时,避免依赖 GUI 登录,优先使用导出的 Environment 文件管理变量与密钥。