Postman Ubuntu版如何调试接口

Ubuntu版 Postman 调试接口实操指南

一 安装与启动

• 方式一 Snap 安装（推荐）
  • 更新并安装 Snap：sudo apt update && sudo apt install snapd
  • 安装 Postman：sudo snap install postman
• 方式二 手动安装
  • 下载 Linux 包：wget https://dl.pstmn.io/download/latest/linux64 -O postman.tar.gz
  • 解压到 /opt：sudo tar -xvf postman.tar.gz -C /opt
  • 创建软链便于启动：sudo ln -s /opt/Postman/Postman /usr/local/bin/postman
  • 创建桌面启动器（可选）：
    • sudo nano /usr/share/applications/postman.desktop
    • 写入：
      • [Desktop Entry]
      • Encoding=UTF-8
      • Name=Postman
      • Exec=/opt/Postman/Postman
      • Icon=/opt/Postman/app/resources/app/assets/icon.png
      • Terminal=false
      • Type=Application
      • Categories=Development;
    • 赋予执行权限：sudo chmod +x /usr/share/applications/postman.desktop
• 启动方式
  • 应用菜单搜索并打开 Postman，或在终端执行：postman。

二 创建请求与查看响应

• 新建请求
  • 点击左上角 New → Request，命名并保存到集合（Collection），便于管理。
• 配置请求
  • 选择方法（如 GET/POST/PUT/DELETE），在地址栏填写完整 URL。
  • 在 Params 添加查询参数；在 Headers 设置如 Content-Type、Authorization；在 Body 选择 raw/JSON 或 form-data 发送数据。
• 发送与查看
  • 点击 Send 发送请求，在下方查看 Status（状态码）、Time（耗时）、Headers 与 Body（支持 Pretty/Raw/Preview 等展示）。

三 变量 认证 与脚本

• 环境变量与全局变量
  • 通过右上角 Manage Environments 创建环境，添加变量（如 base_url、token），在请求中以 {{variable_name}} 引用，便于多环境切换。
• 认证示例（Bearer Token）
  • 登录接口返回 access_token 后，在 Tests 中写入：
    • const jsonData = pm.response.json();
    • pm.environment.set(“accessToken”, jsonData.access_token);
  • 在后续请求的 Headers 添加：Authorization: Bearer {{accessToken}}。
• Pre-request Script
  • 在请求前动态生成参数、时间戳、签名等，例如设置时间戳：
    • pm.environment.set(“timestamp”, Date.now());
• 断言与自动化
  • 在 Tests 使用 pm.expect 等做自动化校验，如：
    • pm.test(“Status 200”, () => pm.response.to.have.status(200));
    • pm.test(“Body has id”, () => pm.expect(pm.response.json()).to.have.property(“id”));
• 批量运行与持续集成
  • 使用 Collection Runner 批量执行请求；将集合与监控集成到 CI/CD（如 Jenkins/GitLab CI）实现定时或提交触发测试。

四 常见问题与网络设置

• 代理配置
  • 若在公司或受限网络，打开 Settings → Proxy，为 HTTP/HTTPS 配置代理；如代理需要认证，勾选 Proxy authentication 并填写用户名与密码。
• 导入导出与团队协作
  • 通过 Import/Export 导入或导出 Collection/Environment 的 JSON 文件，便于分享与版本管理。
• 命令行与快捷启动
  • 已创建软链时可直接执行：postman；桌面环境可通过应用菜单或快捷方式启动。