GitHub Pages报告部署问题：CI中docs文件夹未生成排查

核心问题1：|| true掩盖了命令执行错误 #

你在newman运行命令后加了|| true，这会强制让命令返回成功状态，哪怕newman实际执行失败（比如找不到测试集合文件、依赖加载失败、API请求报错）。这会导致你看不到任何错误日志，误以为是文件夹没生成，实际上是newman根本没成功生成报告。

核心问题2：全局安装Newman及依赖的可靠性问题 #

在GitHub Actions的Ubuntu runner中，全局安装npm包（npm install -g）可能会遇到路径权限问题，或者全局包的PATH未被正确配置，导致newman命令无法被找到，或者无法加载newman-reporter-htmlextra插件。

其他问题 #

• Node环境配置过时：使用的actions/setup-node@v1已经停止维护，Node 16也已结束生命周期，容易出现兼容性问题。
• 冗余的npm操作：npm i npm@latest会强制升级npm到最新版，可能和后续的npm i产生依赖冲突；如果你的项目根目录没有package.json，npm i会直接报错。
• 未验证文件路径：如果petstore.collection.json不在仓库根目录，CI环境中checkout后找不到该文件，newman命令直接失败，但被|| true掩盖。

修复后的配置示例 #

name: Test-Build

on:
  push:
    branches:
      - main

jobs:
  test-api:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: "20.x" # 使用长期支持版Node
          cache: "npm" # 缓存npm依赖，加速构建

      # 本地安装Newman和插件（无需全局安装）
      - name: Install Newman dependencies
        run: |
          npm init -y # 如果没有package.json，先初始化一个
          npm install newman newman-reporter-htmlextra

      - name: Create docs directory
        run: mkdir -p docs

      # 移除|| true，让失败暴露出来
      - name: Run POSTMAN collection
        run: npx newman run petstore.collection.json -r htmlextra --reporter-htmlextra-export docs/index.html

      - name: Upload test reports
        uses: actions/upload-artifact@v4
        with:
          name: RunReports
          path: docs

额外排查建议 #

1. 运行流水线时，查看Run POSTMAN collection步骤的日志，确认是否有文件找不到、依赖加载失败等错误。
2. 确保petstore.collection.json确实存在于仓库根目录，或者在命令中指定正确的相对路径（比如./collections/petstore.collection.json）。
3. 如果需要将docs文件夹推送到GitHub Pages，需要添加额外的步骤将docs目录的内容提交并推送到仓库（或者使用GitHub Pages的部署action）。

内容的提问来源于stack exchange，提问作者Vlad Easy