Ubuntu下Postman的调试方法
小樊
37
2025-12-06 08:11:32
Ubuntu下Postman的调试方法
一 安装与启动
- 使用 Snap 安装(推荐):
- 命令:sudo apt update && sudo apt install snapd
- 安装:sudo snap install postman
- 手动安装(适合离线或受限环境):
- 下载:wget https://dl.pstmn.io/download/latest/linux64 -O postman.tar.gz
- 解压:tar -xvf postman.tar.gz
- 移动:sudo mv Postman /opt
- 软链:sudo ln -s /opt/Postman/Postman /usr/local/bin/postman
- 桌面入口(可选):创建 /usr/share/applications/postman.desktop,内容示例:
- [Desktop Entry]
- Encoding=UTF-8
- Name=Postman
- Exec=postman
- Icon=/opt/Postman/app/resources/app/assets/icon.png
- Terminal=false
- Type=Application
- Categories=Development;
- 启动方式:
- 应用菜单搜索 Postman 打开,或在终端输入 postman。
二 基本调试流程
- 创建与管理请求:
- 新建集合(New > Collection),在集合中 Add request;选择方法(GET/POST/PUT/DELETE),填写 URL,在 Params/Headers/Body 中配置参数与请求体(如 JSON、form-data)。
- 发送与查看响应:
- 点击 Send,在下方查看 状态码、响应头、响应体(支持 Raw/Preview/Pretty 展示)。
- 断言与自动化验证:
- 在 Tests 标签用 JavaScript 编写断言,例如:
- 检查状态码:pm.response.to.have.status(200)
- 解析 JSON 并校验字段:
- const jsonData = pm.response.json();
- pm.expect(jsonData).to.have.property(‘id’).that.is.a(‘number’);
- 环境与变量:
- 通过 Manage Environments 创建环境,变量以 {{variable_name}} 引用,便于在不同环境(如 dev/staging/prod)间切换。
- 预请求脚本:
- 在 Pre-request Script 中生成时间戳、签名或读取变量,为请求做前置准备。
三 脚本调试与日志
- 打开控制台:
- 菜单 View > Show Postman Console 或快捷键 Ctrl+Alt+C,查看请求与响应详情、脚本输出与错误堆栈。
- 输出调试信息:
- 在 Pre-request Script 或 Tests 中使用 console.log(‘token=’, pm.environment.get(‘accessToken’)) 打印变量与流程信息。
- 批量运行与报告:
- 使用 Collection Runner 批量执行请求并查看断言结果;可将集合与 Monitor 结合,定时运行并生成报告。
四 认证与Token自动化示例
- 登录后提取并保存 access_token:
- 在登录请求的 Tests 中:
- const jsonData = pm.response.json();
- if (jsonData.code === 200 && jsonData.result) {
- pm.environment.set(‘accessToken’, jsonData.result);
- }
- 在后续请求中使用:
- Headers 添加:Authorization: Bearer {{accessToken}}
- 动态签名或时间戳(Pre-request Script 示例):
- const ts = Date.now();
- pm.environment.set(‘ts’, ts);
- // 结合服务端签名规则生成 sign 后再设置到变量
五 常见问题与排查
- 无法启动或找不到命令:
- 确认软链路径正确:ls -l /usr/local/bin/postman;必要时重新创建软链或直接使用 /opt/Postman/Postman。
- 界面打不开或卡顿:
- 关闭不必要的集合运行器/监视器;更新到最新版本;检查系统资源(内存/磁盘)。
- 请求失败排查顺序:
- 在控制台核对完整 URL、Headers、Body;确认环境变量已正确渲染(如 {{baseUrl}})。
- 使用 Tests 输出关键响应片段,定位是网络层(超时、DNS)、协议层(TLS/证书)、还是业务层(状态码、业务码)。
- 认证问题:
- 确认 Authorization 头拼写与 Bearer 前缀;确保 accessToken 未过期并已在环境中正确设置。