通过代码触发GitHub workflow_dispatch事件后工作流未运行如何解决

你遇到的问题属于常见配置遗漏，不属于GitHub已知Bug，可按以下优先级排查：

1. 权限配置错误（最高发原因） #

GitHub默认的GITHUB_TOKEN权限存在限制：由GITHUB_TOKEN触发的操作不会二次触发其他工作流，这是官方设计的防止循环触发的安全机制，所以你虽然拿到了204的成功响应，但GitHub后台会直接拦截后续工作流的触发请求。

解决方法： #

• 生成具备workflow权限的个人访问令牌（PAT）
• 将PAT存入对应仓库的Secrets中，假设命名为WORKFLOW_TRIGGER_TOKEN
• 替换原有触发步骤中的${{ github.token }}为${{ secrets.WORKFLOW_TRIGGER_TOKEN }}

2. ref参数不匹配 #

你触发时传入的ref参数需要满足两个条件：

• release-single.yaml文件必须存在于该ref对应的分支/标签上
• 你传入的${{ github.ref }}如果不是master分支（比如是其他功能分支、tag），而release-single.yaml只存在于master分支上，就会出现无运行记录的问题

解决方法： #

直接指定ref为master分支，示例：

# github-script方案
ref: "master"
# benc-uk/workflow-dispatch方案
ref: "master"

3. 参数传递问题 #

你配置中label为非必填参数，如果${{ matrix.label }}为空值，直接传入空字符串可能会触发参数校验不通过，后台会静默拒绝执行。

解决方法： #

只传递非空的label参数，或者给label配置默认值，示例：

inputs: {
  type: "${{ matrix.type }}",
  version: "${{ matrix.version }}",
  tag: "${{ matrix.tag }}"
  ${{ if matrix.label }} , label: "${{ matrix.label }}" ${{ endif }}
}

4. 工作流标识匹配问题 #

• 确认release-single.yaml文件确实存放在仓库的.github/workflows/目录下
• 确认文件名大小写完全匹配，GitHub对文件名大小写敏感
• 如果使用工作流名称触发（benc-uk的方案），确认名称和release-single.yaml中定义的name: Release Single完全一致，包括空格大小写

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