Postman Ubuntu如何进行API测试

在 Ubuntu 上使用 Postman 进行 API 测试

一安装 Postman

使用 Snap（推荐，系统自带软件源，便于更新）
- 安装命令：sudo snap install postman --classic
- 启动方式：应用菜单搜索“Postman”或在终端输入：postman
使用 APT 仓库
- 导入 GPG 并添加源：
  - wget -qO - https://dl.postman.co/postman.gpg | sudo apt-key add -
  - echo “deb https://dl.postman.co/debian $(lsb_release -cs) main” | sudo tee /etc/apt/sources.list.d/postman.list
- 安装与启动：
  - sudo apt update && sudo apt install postman
  - 启动：postman
使用 Flatpak
- 安装与运行：
  - sudo apt update && sudo apt install flatpak
  - flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
  - flatpak install flathub com.postman.Postman
  - 启动：flatpak run com.postman.Postman
手动安装（下载安装包）
- 下载并解压到 /opt：
  - 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]
    - Name=Postman
    - Exec=/usr/local/bin/postman
    - Icon=/opt/Postman/app/resources/app/assets/icon.png
    - Terminal=false
    - Type=Application
    - Categories=Development;
  - 赋予可执行权限：sudo chmod +x /usr/share/applications/postman.desktop 以上方式均为在 Ubuntu 上常用的安装途径，任选其一即可。

二创建请求与编写测试

新建请求
- 在 Postman 中点击左上角“+”新建请求，选择 GET/POST/PUT/DELETE 等方法，填写 URL，按需设置 Headers/Params/Body，点击“Send”发送。
使用集合与环境
- 将相关请求保存到 Collection 便于管理与复用；通过 Environment 管理不同环境（如 dev/staging/prod）的变量（如 {{base_url}}、{{api_key}}），在请求中以 {{变量名}} 引用。
编写测试脚本（Tests 标签，JavaScript）
- 常用断言示例：
  - 验证状态码：pm.test(“Status code is 200”, () => pm.response.to.have.status(200));
  - 验证响应体字段：pm.test(“Name is correct”, () => pm.expect(pm.response.json().name).to.eql(“test_user”));
  - 验证响应时间：pm.test(“Response time < 500ms”, () => pm.expect(pm.response.responseTime).to.be.below(500));
运行与查看结果
- 在集合或请求上点击“Run”执行，查看每个请求的 Test Results 面板，定位失败断言与响应详情。

三命令行自动化与 CI 集成

使用 Newman 运行集合
- 安装：npm install -g newman
- 运行示例：
  - 仅运行集合：newman run your_collection.json
  - 指定环境：newman run your_collection.json --environment your_env.json
生成报告并接入 CI（GitHub Actions 示例）
- 示例工作流片段：
  - - name: Install newman
    - run: npm install -g newman
  - - name: Run Postman tests
    - run: newman run “your_postman_collection.json” --reporters cli,junit --reporter-junit-export report.xml
  - - name: Publish test results
    - uses: actions/upload-artifact@v2
    - with: { name: postman-test-results, path: report.xml } 上述流程可在 Ubuntu 的 CI 环境中执行 Postman 集合，输出 CLI 与 JUnit 报告，便于质量门禁与可视化。

四常见问题与实用建议

权限与运行
- 避免用 sudo 启动 Postman，防止创建的文件产生权限问题；若遇到启动异常，优先检查权限与用户目录可写性。
依赖缺失
- 若出现类似 libgconf-2.so.4 缺失的错误，安装：sudo apt install libgconf2-4
代理配置
- 在 Postman 右上角齿轮进入 Settings → General → Proxy，按需配置 HTTP/HTTPS 代理 与认证信息，确保内网或受限网络下的请求可达。
安装方式选择
- 桌面用户优先 Snap（更新与依赖管理更简单）；服务器或无图形环境建议 Newman 做 CLI 自动化；需要多环境分发时可用 APT/Flatpak/手动安装 结合内部分发机制。

最新问答

相关标签