Ubuntu下Postman的调试方法

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 未过期并已在环境中正确设置。