Ubuntu 下使用 Postman 进行接口调试
一 安装与启动
- 使用 Snap（推荐）：在终端执行
sudo snap install postman --classic
安装完成后可直接在应用菜单或终端输入 postman 启动。
- 使用 APT 仓库（官方）：
wget -qO - https://dl.postman.co/postman.gpg | sudo apt-key add -
sudo sh -c ‘echo “deb https://dl.postman.co/debian $(lsb_release -cs) main” > /etc/apt/sources.list.d/postman.list’
sudo apt update && sudo apt install postman
- 使用 Flatpak：
sudo apt install flatpak
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
flatpak install flathub com.postman.Postman
- 手动安装（下载解压）：
wget https://dl.pstmn.io/download/latest/linux64 -O postman.tar.gz
sudo tar -xzf postman.tar.gz -C /opt
sudo ln -s /opt/Postman/Postman /usr/local/bin/postman
如需桌面图标，可创建文件 /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 update-desktop-database。
二 快速调试流程
- 创建或导入请求：新建请求或导入 Collection，选择 GET/POST/PUT/DELETE 等方法，填写 URL。
- 设置请求头与请求体：在 Headers 添加如 Content-Type、Authorization；在 Body 选择 JSON / x-www-form-urlencoded / form-data / raw / binary 等格式并填写内容。
- 发送请求与查看结果：点击 Send，在下方查看 状态码、响应头、响应体，核对是否符合预期。
- 保存与复用：保存请求或加入 Collection，便于后续复用与分享。
三 变量环境与脚本
- 环境变量与多环境：创建 Environment，添加如 {{base_url}}、{{api_key}} 等变量，在请求中以 {{变量名}} 引用，便于在 开发/测试/生产 环境间切换。
- Pre-request Script：请求发送前执行，常用于生成 时间戳、签名、动态 Header。示例：
// Pre-request Script
const ts = Date.now();
pm.environment.set(“ts”, ts);
pm.request.headers.add({ key: “X-Timestamp”, value: ts });
- Tests 断言：响应返回后执行，用于自动化校验。示例：
// Tests
pm.test(“Status is 200”, () => pm.response.to.have.status(200));
pm.test(“Response time < 300ms”, () => pm.expect(pm.response.responseTime).to.be.below(300));
const json = pm.response.json();
pm.test(“Has id field”, () => pm.expect(json).to.have.property(“id”));
- 批量运行与监控：使用 Collection Runner 批量执行请求；通过 Monitor 定期运行并生成报告，便于持续验证接口稳定性。
四 常见问题与排查
- 依赖缺失导致启动失败：若提示缺少 libgconf-2.so.4，安装依赖
sudo apt install libgconf2-4
- 代理配置：在 Settings → General → Proxy 中配置 HTTP/HTTPS 代理；如代理需要认证，勾选 Proxy authentication 并填写凭据。
- 命令行启动与路径：若采用手动安装，确保软链正确（如 /usr/local/bin/postman），或直接在 /opt/Postman/Postman 启动。
- 避免使用 sudo 启动 GUI：可能导致配置文件与缓存产生 权限问题，建议普通用户直接启动。
