使用mikepenz/action-junit-report@v3创建Checks失败问题排查

核心原因：默认GITHUB_TOKEN权限不足 #

默认的GITHUB_TOKEN未被授予创建Checks所需的checks:write权限，这是触发该错误的最常见原因。

解决步骤 #

• 在工作流中显式配置权限：在workflow文件开头添加权限声明，授予必要权限：

  permissions:
    checks: write
    contents: read
  

  完整配置示例：

  name: Test Workflow
  on: [pull_request, push]
  
  permissions:
    checks: write
    contents: read
  
  jobs:
    test:
      runs-on: ubuntu-latest
      steps:
        - uses: actions/checkout@v4
        # 此处添加你的测试执行步骤
        - name: register test
          uses: mikepenz/action-junit-report@v3
          if: always()
          with:
            report_paths: '**/build/test-results/test/TEST-*.xml'
            token: ${{ secrets.GITHUB_TOKEN }}
  

• 检查仓库Actions权限设置：

  1. 进入仓库Settings → Actions → General
  2. 在「Workflow permissions」区域，确保选择「Read and write permissions」
  3. 私有仓库需确认无额外权限限制

• 验证测试报告路径有效性：
  若report_paths未匹配到任何测试报告文件，也可能引发异常。可在该步骤前添加验证步骤：

  - name: Check test report files
    run: find . -name "TEST-*.xml" -path "*/build/test-results/test/*"
  

其他排查方向 #

若上述方法无效，检查以下场景：

• 分支保护规则限制了Actions操作
• 使用自定义token而非默认GITHUB_TOKEN，但该token权限不足
• 仓库所属组织的权限策略限制了Checks创建

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