Postman在Ubuntu上如何生成报告 - 问答

在 Ubuntu 上生成 Postman 报告的实用方案

一准备导出文件与环境

在 Postman 中导出：
- 集合 Collection：左侧 Collections → 目标集合右侧 … → Export → 选择 v2.1，保存为 .postman_collection.json。
- 环境 Environment：右上角 齿轮 → Manage Environments → 目标环境 → Download，保存为 .postman_environment.json。
- 全局变量 Globals：同页 Globals → Download，保存为 .postman_globals.json。
- 数据文件（可选，用于参数化）：准备 data.csv 或 data.json，首行或键名需与请求中的变量名一致。
在 Ubuntu 安装 Node.js 与 npm（示例）：
- 安装 Node.js（建议 Node ≥ 14），验证：node -v、npm -v。
安装 Newman（Postman 命令行运行器）：
- 全局安装：npm install -g newman。
如需 HTML 报告，安装 HTML 报告插件（见下文各方案）。

二本地生成报告

方案 A HTML 报告（newman-reporter-html）
- 安装插件：npm install -g newman-reporter-html。
- 运行示例：
```
newman run collection.json \
  -e environment.json \
  -d data.json \
  -r html \
  --reporter-html-export report.html
```
- 报告将导出为 report.html，可用浏览器打开查看。

方案 B Allure 报告（更美观，适合 CI）

安装 Allure 命令行（示例）：

curl -o- https://dl-cli.pstmn.io/install/linux64.sh | sh
allure --version

运行并导出 Allure 结果：

newman run collection.json \
  -e environment.json \
  -r allure \
  --reporter-allure-export allure-results

生成 HTML 并打开：

allure generate allure-results -o allure_html --clean
allure open allure_html

如需同时输出控制台与 Allure，可用：-r cli,allure。

方案 C 其他报告格式（JSON、JUnit）

同时输出控制台、JSON、JUnit：

newman run collection.json \
  -e environment.json \
  -d data.json \
  -r cli,json,junit \
  --reporter-json-export result.json \
  --reporter-junit-export result.xml

适合接入 Jenkins、GitLab CI 等流水线做质量门禁与报表归档。

三常见报错与排查

报错：newman: “html” reporter could not be loaded.
- 原因：未安装 HTML 报告插件。
- 解决：npm install -g newman-reporter-html，再执行命令。
报错：找不到环境/数据文件
- 解决：使用绝对路径或确保相对路径正确，例如：newman run /path/collection.json -e /path/env.json -d /path/data.json。
报告生成但为空或无断言结果
- 解决：确认 Collection 的 Tests 脚本中已编写断言（如 pm.test），否则报告无失败/通过统计。

四在 CI 中使用 Postman CLI 生成报告

在 GitHub Actions 示例（Ubuntu runner）：

name: Run Postman Tests
on: push
jobs:
  postman-tests:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Install Postman CLI
        run: curl -o- "https://dl-cli.pstmn.io/install/linux64.sh" | sh
      - name: Login to Postman CLI
        run: postman login --with-api-key ${{ secrets.POSTMAN_API_KEY }}
      - name: Run Collection
        run: |
          postman collection run ${{ secrets.COLLECTION_ID }} \
            --environment ${{ secrets.ENVIRONMENT_ID }} \
            --reporters cli,json,junit \
            --reporter-json-export result.json \
            --reporter-junit-export result.xml

说明：Postman CLI 适合在 CI 中直接运行集合；若需 Allure/HTML 报告，仍建议使用 Newman 在 CI 步骤中执行并导出结果。

0 赞

0 踩