为什么协作者从fork提交的Pull Request未触发Actions/workflow运行

云原生阿岚

2026-9-27

可能的问题原因

Workflow触发配置不匹配：你当前的CI配置仅设置了on: [push]作为触发条件，该事件仅会在代码直接推送到当前仓库时触发。你从fork分支向上游仓库提交PR的操作不属于向上游仓库推送代码的行为，因此上游仓库不会匹配到push事件触发CI。如果需要上游仓库在收到PR时自动运行CI，需要将触发条件调整为：
```
on: [push, pull_request]
```
上游仓库设置了严格的Fork PR Actions权限：即使你是仓库的collaborator，上游仓库管理员可手动修改Actions默认规则，设置所有从Fork发起的PR无论贡献者身份都需要人工审批后才能运行Workflow，不受「首次贡献者才需要审批」的默认规则限制。
collaborator权限等级不足：如果给你分配的collaborator权限仅为读取/提案权限，没有仓库写入权限，系统仍会将你识别为外部贡献者，你发起的Fork PR还是需要走审批流程才会运行Workflow。
上游仓库分支保护规则限制：如果上游仓库的master分支设置了特殊的CI运行限制，例如仅允许直接推送至master的提交触发CI、排除来自Fork的PR触发CI，也会导致对应的Workflow不运行。
Workflow配置仅存在于你的Fork仓库：如果这份CI配置文件没有合并到上游仓库的master分支，仅存在于你自己的Fork仓库分支中，上游仓库会识别不到对应的Workflow规则，自然不会触发运行。