CentOS Postman接口调试

CentOS 下使用 Postman 进行接口调试

一 安装与启动

• 下载并解压
  • 访问 Postman 官网下载 Linux 64 位安装包（.tar.gz），在终端执行：
    • wget https://dl.pstmn.io/download/latest/linux64 -O postman.tar.gz
    • tar -xzf postman.tar.gz -C /opt
• 创建软链便于启动
  • sudo ln -s /opt/Postman/Postman /usr/local/bin/postman
  • 启动：在终端输入：postman
• 可选 桌面快捷方式
  • 创建文件：~/.local/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
  • 更新启动器：update-desktop-database
• 无图形界面服务器建议用 Newman（见第三部分）。

二 图形界面调试要点

• 创建与管理请求
  • 新建请求（GET/POST 等），在 URL 输入地址；在 Headers 添加如 Content-Type: application/json；在 Body 选择 raw-JSON 填写请求体。
• 环境变量与多环境
  • 在右上角选择或新建 Environment，变量如 base_url；在请求中使用 {{base_url}} 引用，便于在 开发/测试/生产 间切换。
• 认证与请求体
  • 在 Authorization 选择 Basic Auth/OAuth 2.0 等；表单可用 form-data 或 x-www-form-urlencoded，文件上传用 binary。
• 控制台与脚本调试
  • 打开控制台：View → Show Postman Console（快捷键 Ctrl+Alt+C），使用 console.log() 输出变量。
  • Tests 示例：
    • pm.test(“Status code is 200”, () => pm.response.to.have.status(200));
  • Pre-request 示例：
    • pm.environment.set(“page”, 1);
• 变量作用域
  • 合理使用 Environment 与 Global 变量；同名时全局会覆盖环境，注意命名与清理。

三 无头环境自动化 Newman

• 安装 Node.js 与 Newman
  • sudo yum install -y nodejs npm
  • sudo npm install -g newman
• 运行集合与环境
  • 在 Postman 中导出 集合 Collection.json 与 环境 Environment.json，在服务器执行：
    • newman run collection.json -e environment.json
• 生成报告与持续集成
  • 生成 HTML 报告（需 Newman 报告插件，如 newman-reporter-html）：
    • newman run collection.json -e environment.json -r html --reporter-html-export report.html
  • 可用 Shell 脚本封装、配合 systemd 或 CI 定时/触发执行，实现无人值守回归。

四 常见问题与排查

• 依赖与启动错误
  • 如遇共享库缺失（如：error while loading shared libraries: libXss.so.1），安装：
    • sudo yum install libXScrnSaver
• 权限与目录
  • 安装到系统目录或执行全局命令时使用 sudo；确保解压目录与软链权限正确。
• 网络与证书
  • 确认服务器可达；自签名证书可在 Newman 中临时关闭校验（不建议生产）：
    • newman run collection.json -e environment.json --insecure
  • 更佳做法是导入受信任 CA/证书 到系统信任库。
• 服务端问题
  • 检查目标服务日志与路由配置，确认接口可用与返回预期状态码。
• 日志与输出
  • 图形界面用 Postman Console 查看请求/响应与脚本输出；命令行用 -r cli,html 等报告插件获取更详细日志。