跨仓库触发GitHub Actions工作流遇404错误求助

以下是你可能遗漏的核心配置或操作步骤：

1. 确认Repo A的工作流已配置正确的触发事件 #

如果使用workflow_dispatch触发，Repo A的工作流文件必须明确声明该触发器：

on:
  workflow_dispatch:
    # 可选：按需定义输入参数
    inputs:
      environment:
        description: '部署环境'
        required: true
        default: 'dev'

如果更适合跨仓库场景的repository_dispatch触发，则工作流要监听对应事件：

on:
  repository_dispatch:
    types: [terraform-deploy] # 自定义事件类型，需与API调用参数匹配

2. 检查API请求端点的正确性 #

404错误最常见的原因是端点路径错误：

• 若用workflow_dispatch，正确端点格式为：

  https://api.github.com/repos/<OWNER>/repoA/actions/workflows/<WORKFLOW_ID_OR_FILENAME>/dispatches
  

  可通过gh workflow list -R <OWNER>/repoA获取工作流的ID或文件名（比如deploy-terraform.yml），确保curl调用时使用准确值。
• 若用repository_dispatch，正确端点为：

  https://api.github.com/repos/<OWNER>/repoA/dispatches
  

3. 确保触发Token拥有足够权限 #

你在Repo B中使用的GitHub Token（通常存储在Repo B的Secrets中）必须满足：

• 对Repo A拥有写入权限（私有仓库需repo权限，公共仓库需workflows权限）
• 若属于组织仓库，需确认组织未限制跨仓库Token的权限范围
• 禁止使用默认的GITHUB_TOKEN，它仅对当前仓库（Repo B）生效，必须使用拥有Repo A访问权限的**个人访问令牌（PAT）**或组织级令牌

4. 验证HTTP请求的头部和参数 #

curl请求必须包含正确的头部与请求体：

• 必须设置Authorization: token <YOUR_TOKEN>头部
• 必须设置Accept: application/vnd.github.v3+json头部以兼容API版本
• 若用workflow_dispatch，请求体需包含分支名ref：

  curl -X POST \
    -H "Authorization: token ${{ secrets.REPO_A_TOKEN }}" \
    -H "Accept: application/vnd.github.v3+json" \
    https://api.github.com/repos/<OWNER>/repoA/actions/workflows/deploy-terraform.yml/dispatches \
    -d '{"ref": "main"}'
  

• 若用repository_dispatch，请求体需包含匹配的event_type：

  curl -X POST \
    -H "Authorization: token ${{ secrets.REPO_A_TOKEN }}" \
    -H "Accept: application/vnd.github.v3+json" \
    https://api.github.com/repos/<OWNER>/repoA/dispatches \
    -d '{"event_type": "terraform-deploy", "client_payload": {"environment": "dev"}}'
  

5. 确认Repo A的工作流未被禁用 #

在Repo A的Actions页面，检查目标工作流是否处于启用状态——禁用的工作流无法被API触发，可能返回404或403错误。

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