创建组织私有仓库Workflow Dispatch事件时遭遇404(Not Found)错误

你在调用GitHub API触发私有组织仓库的Workflow Dispatch时遇到404错误，以下是针对性的排查要点：

• 校验路径参数的准确性

  • 确认组织名、仓库名拼写完全正确，GitHub的仓库路径区分大小写，比如MyRepo和myrepo是两个不同的仓库
  • 检查workflow_id：可以使用工作流文件的完整文件名（如deploy.yml）或工作流的数字ID。如果用文件名，要确保该文件存在于你指定的ref分支中；如果用数字ID，可在仓库的Actions页面，点击对应工作流，从URL中获取（比如URL末尾的?workflow_id=1234567）
  • 分支名ref必须是仓库中存在的有效分支，同样注意大小写，且该分支未被删除或设为私有

• 验证令牌的实际权限与有效性

  • 确认个人令牌未过期、未被撤销。可以用以下命令测试令牌对目标仓库的访问权限：

    curl -H "Authorization: Bearer <你的令牌>" https://api.github.com/repos/<组织名>/<仓库名>
    

    如果这个请求返回404，说明令牌无法访问该仓库，可能是组织管理员设置了IP白名单、令牌的仓库访问权限被修改，或者令牌的权限范围实际未覆盖该仓库
  • 检查令牌的Authorization头格式：确保Bearer与令牌之间有空格，比如Bearer abc123而非Bearerabc123

• 检查请求格式与API端点

  • 确认请求的JSON数据格式正确：-d '{"ref":"<分支名>"}'中的分支名替换后，JSON语法没有错误（双引号正确闭合，无多余符号）
  • 确认API端点正确：GitHub官方的Workflow Dispatch端点确实是https://api.github.com/repos/<组织>/<仓库>/actions/workflows/<workflow_id>/dispatches，无需修改域名

• 检查工作流的触发设置

  • 打开目标工作流文件，确认顶部包含on: workflow_dispatch配置，如果没有这个触发条件，API调用会返回404（因为该工作流不支持手动触发）
  • 确认工作流文件存在于你指定的ref分支下，比如你指定分支为dev，要确保dev分支的.github/workflows/目录下有该工作流文件

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