Postman在Ubuntu上的报告生成

在Ubuntu上生成Postman报告的可选方案

• 使用桌面版 Postman 的 Runner 在本地运行集合，适合临时调试与演示。运行结果可在 Runner 标签页查看，但内置报告以界面展示为主，若需对外分享建议导出或改用命令行工具生成报告。
• 使用 Newman（Postman 的命令行集合运行器）在 Ubuntu 终端批量运行集合并生成 HTML、JSON 等报告，便于保存、归档与集成到 CI/CD。
• 使用 Postman CLI（Newman 的官方演进形态）在 CI 环境（如 GitHub Actions）中执行集合，结合 API Key 登录，适合自动化流水线。

方案一 Newman生成HTML报告步骤

• 安装 Node.js 与 Newman
  • 安装 Node.js（建议 Node.js 14+），然后执行：npm install -g newman
• 在 Postman 中导出文件
  • 导出 集合 Collection（.json）、如有则导出 环境变量 Environment（.json）、如需数据驱动则导出 数据文件 CSV/JSON。
• 在 Ubuntu 终端执行并生成报告
  • 基本命令：newman run collection.json -e environment.json -d data.csv -r html --reporter-html-export report.html
  • 常用选项：
    • -n 指定迭代次数（如 -n 3）
    • –reporters cli,html,json 同时输出多种报告
    • 如不指定 --reporter-html-export，Newman 会在当前目录生成 newman 文件夹存放报告
• 查看报告
  • 生成的 report.html 可用浏览器打开，适合分享与归档。

方案二 使用Postman CLI在GitHub Actions中生成报告

• 在仓库中添加 Postman API Key 到 Secrets（Settings > Secrets and variables > Actions > New repository secret，名称如 POSTMAN_API_KEY）。
• 在 .github/workflows/ 下创建工作流（如 run-postman-tests.yml），示例：
  • name: Run Postman Collection
    on: push: branches: [ main ]
    jobs:
    postman-cli-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 <collection_id> --environment <environment_id> \ –reporters cli,html --reporter-html-export report.html
• 在 Actions 中查看运行日志与产物，报告 HTML 可上传为 Artifact 供下载。

方案三 桌面版Postman Runner的使用提示

• 在 Postman 中创建并保存 集合，点击底部 Runner 进入运行器。
• 将要运行的集合拖入 Runner，按需设置 Iterations（迭代次数）、Delay（延时）、Data（数据文件） 等参数后运行。
• 运行结果（请求响应、断言结果、耗时等）会在 Runner 界面展示；如需对外分享，建议改用 Newman 生成 HTML 报告。

常见问题与实用建议

• 报告不生成或为空：检查集合、环境、数据文件路径是否正确；确保有 Tests 断言；必要时添加 -r cli 查看实时日志。
• HTML 报告中文乱码：在导出或查看环境中使用 UTF-8 编码；必要时在 Newman 命令前设置环境变量：export LANG=en_US.UTF-8。
• 参数化与数据驱动：使用 CSV/JSON 数据文件，CSV 首行需与集合变量名一致；在 Tests 中通过 pm.variables.get(“变量名”) 读取。
• CI 中产物保存：在 GitHub Actions 使用 actions/upload-artifact 上传 report.html，便于归档与下载。
• 选择建议：本地快速调试用 Runner；稳定生成与归档用 Newman；自动化流水线优先 Postman CLI。