在 CentOS 上使用 Postman 调试接口
一 安装与启动
- 下载并解压 Linux 版本 Postman(.tar.gz),建议放到 /opt:
- wget https://dl.pstmn.io/download/latest/linux64 -O postman.tar.gz
- sudo tar -xzf postman.tar.gz -C /opt
- 创建软链接,便于在终端直接启动:
- sudo ln -sfn /opt/Postman/Postman /usr/bin/postman
- 启动:
- 如无图形界面,可使用 X11 转发 或 VNC 远程打开界面(服务器场景常见)。
二 图形界面调试步骤
- 创建请求:选择 GET/POST 等方法,填写 URL;在 Params 填查询参数,在 Headers 填如 Content-Type: application/json,在 Body 选择 raw → JSON 填写请求体。
- 环境与变量:在右上角选择或新建 Environment,用 {{base_url}} 等变量替换硬编码;在请求中使用如 https://{{base_url}}/users。
- 认证:在 Authorization 中选择 Basic Auth/OAuth 2.0 等方式填写凭据。
- 调试输出:打开 View → Show Postman Console(Ctrl+Alt+C),用 console.log() 输出变量;在 Tests 标签编写断言,如:
- pm.test(“Status code is 200”, () => pm.response.to.have.status(200));
- 集合与自动化:将相关接口保存为 Collection,用 Collection Runner 批量运行并查看结果。
三 无界面与自动化 Newman
- 安装 Node.js 与 Newman:
- sudo yum install -y nodejs npm
- sudo npm install -g newman
- 运行集合与环境:
- newman run collection.json -e environment.json
- 生成报告(需插件):
- sudo npm install -g newman-reporter-html
- newman run collection.json -e environment.json -r html --reporter-html-export report.html
- 持续集成:将导出 collection.json / environment.json 纳入代码仓库,在 Jenkins/GitLab CI 中执行 Newman 并归档报告。
四 常见问题与排查
- 代理配置:在 Settings → General → Proxy 配置 HTTP/HTTPS 代理,或设置环境变量 HTTP_PROXY/HTTPS_PROXY。
- 证书问题:测试环境可在请求中临时关闭 SSL certificate verification;生产环境应导入可信 CA 证书。
- 权限与依赖:如无权限或依赖缺失,使用 sudo 安装/运行;必要时安装缺失库(如 libgconf-2-4 等)。
- 变量作用域:区分 Environment 与 Global;在 Tests/Pre-request Script 中用 pm.environment.set() / pm.globals.set() 设置,注意不同运行方式对变量持久化的影响。
- Cookie 与 Header:读取 set-cookie 时注意判空与多次运行导致的 null 问题,可用 (cookied || “”).split(“;”) 规避;通过 postman.getResponseHeader / getResponseCookie 取值。