CentOS 中 Postman 调试接口实操指南
一 安装与启动
- 手动安装(通用)
- 下载 Linux 64 位包并解压到 /opt:
- wget https://dl.pstmn.io/download/latest/linux64 -O postman.tar.gz
- sudo mkdir -p /opt/postman && sudo tar -xzf postman.tar.gz -C /opt/postman
- 创建软链便于命令行启动:sudo ln -s /opt/postman/Postman/Postman /usr/bin/postman
- 启动:在终端输入 postman
- 其他可选方式
- Snap:sudo yum install snapd && sudo systemctl enable --now snapd.socket && sudo ln -s /var/lib/snapd/snap /snap && sudo snap install postman --classic
- 桌面启动器(可选):创建 /usr/share/applications/postman.desktop,Exec=/usr/bin/postman,Icon=/usr/local/postman/app/resources/app/assets/icon.png
- 常见依赖与权限
- 依赖缺失:sudo yum install libXScrnSaver(部分环境还可能需要 libgconf-2-4)
- 权限问题:无法写入配置目录时,修正 ~/.config/Postman 权限或以合适权限运行
二 发送请求与查看响应
- 新建请求:点击左上角 New → HTTP Request,选择 GET/POST/PUT/DELETE 等方法
- 配置请求
- URL:如 https://api.example.com/login
- Headers:如 Content-Type: application/json、Authorization: Bearer {{token}}
- Body(POST/PUT):选择 raw → JSON,示例:{“username”:“test”,“password”:“123456”}
- 发送与查看:点击 Send,在下方查看 Status、Response Time、Headers、Body(JSON 自动格式化)
- 组织与复用:将请求保存到 Collection,便于批量管理与回归
三 调试技巧与自动化
- 变量与环境
- 创建环境(Dev/Prod),添加变量如 base_url、token;在请求中使用 {{base_url}}/login
- 登录后将响应中的 token 写入环境:pm.environment.set(“token”, pm.response.json().token)
- Pre-request Script 与 Tests
- Pre-request:生成时间戳/签名
- const ts = Date.now(); pm.variables.set(“timestamp”, ts);
- Tests:断言与日志
- 状态码:pm.test(“Status is 200”, () => pm.response.to.have.status(200));
- 响应时间:pm.test(“Response < 200ms”, () => pm.expect(pm.response.responseTime).to.be.below(200));
- 字段校验:const j = pm.response.json(); pm.expect(j).to.have.property(“userId”).that.is.a(“number”);
- 日志:console.log(“token =”, pm.variables.get(“token”));
- 控制台与抓包
- 打开控制台:View → Show Postman Console(或快捷键 Ctrl+Alt+C),查看 console.log 输出
- 外部代理抓包:在 Postman → Settings → Proxy 设置 127.0.0.1:8888,配合 Fiddler/Charles 查看完整流量
- 自动化与报告
- 安装 Newman:sudo npm install -g newman
- 运行集合:newman run collection.json -e environment.json
- HTML 报告:newman run collection.json -e environment.json --reporters html --reporter-html-export report.html
四 常见问题排查
- 网络与防火墙
- 连通性:ping www.baidu.com
- 放行端口(如被测服务在 9999):sudo firewall-cmd --permanent --zone=public --add-port=9999/tcp && sudo firewall-cmd --reload
- 代理设置
- Postman → Settings → Proxy,关闭 Global Proxy Configuration(如无需要),避免被系统代理拦截
- SSL 证书
- 临时方案(不推荐生产):Postman → Settings → SSL certificate verification 关闭
- 推荐方案:将服务器证书导入 Postman 信任库
- 请求超时
- Postman → Settings → General → Request timeout(单位毫秒),适当增大
- 依赖与启动异常
- 安装缺失库:sudo yum install libXScrnSaver(必要时 libgconf-2-4)
- 权限问题:修正 ~/.config/Postman 权限或以合适权限运行