GitHub Actions中workflow_run触发依赖项目工作流失败排查

你的配置存在以下几个关键缺失点，导致触发失败：

1. 跨仓库触发未指定目标仓库（若两项目为不同仓库） #

如果SHARED-PROJECT和DEPENDANT-PROJECT是不同GitHub仓库，DEPENDANT的workflow_run触发器必须明确指定SHARED仓库的完整路径，否则GitHub会默认在当前仓库（DEPENDANT）中查找名为SHARED-PROJECT-CI-BUILD的工作流，自然无法匹配。

修改DEPENDANT的触发器配置：

on:
  push:
    branches-ignore:
      - master
    paths:
      - 'dependant-project/**'
  workflow_run:
    workflows: ["SHARED-PROJECT-CI-BUILD"]
    # 添加这一行，替换为SHARED仓库的owner/仓库名
    repository: "你的GitHub用户名/SHARED-PROJECT"
    types:
      - completed

2. 权限配置不足 #

仓库权限设置 #

• 在DEPENDANT-PROJECT仓库的Settings > Actions > General中，确保Workflow permissions设置为Read and write permissions，否则工作流无法读取跨仓库的workflow_run事件。
• 若为企业级仓库，还需检查组织层面的Actions权限是否允许跨仓库触发。

工作流身份验证 #

跨仓库触发时，DEPENDANT的工作流需要有访问SHARED仓库事件的权限，可通过以下方式解决：

• 使用具有repo权限的Personal Access Token (PAT)，在DEPENDANT仓库的Secrets中添加该令牌，并在checkout步骤中指定：

- name: Checkout Source
  id: checkout
  uses: actions/checkout@v4
  with:
    ref: ${{ github.event.workflow_run.head_branch }}
    token: ${{ secrets.CROSS_REPO_PAT }}

3. 分支匹配逻辑潜在问题 #

SHARED的工作流排除了master分支，但DEPENDANT触发后会checkout SHARED的head_branch，如果该分支在DEPENDANT仓库中不存在，会导致checkout失败。需确保DEPENDANT仓库中存在对应的分支，或者调整checkout逻辑（比如默认checkout当前仓库的对应分支）。

4. 验证SHARED工作流是否实际运行 #

先确认SHARED-PROJECT的变更确实触发了SHARED-PROJECT-CI-BUILD工作流并完成：

• 进入SHARED仓库的Actions页面，查看对应提交的工作流运行记录，确保没有因路径匹配、权限等问题导致工作流未执行。

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