GitHub Actions中无法调用私有仓库的问题求助

云上老周

2026-7-5

解决同组织私有仓库调用自定义GitHub Action时的“repository not found”错误

针对你遇到的仅单个同组织私有仓库无法调用自定义Action的问题，可按以下步骤排查：

检查目标仓库的Actions权限限制
进入该仓库的Settings > Actions > General，确认Actions permissions设置为Allow all actions and reusable workflows，或已将存放自定义Action的私有仓库添加至允许列表。部分仓库可能被单独配置了 stricter 的权限规则，而非继承组织默认设置。
验证Action调用语法的完整性
调用私有仓库Action必须指定完整路径与版本号，例如：
```
- uses: org_name/repo_name/.github/workflows/action.yml@v1
```
同时检查组织名、仓库名、文件名的拼写（尤其是大小写），GitHub仓库名不区分大小写，但Action路径中的文件名需严格匹配。
确认工作流令牌的读取权限
工作流默认的GITHUB_TOKEN需具备读取私有仓库的权限。在问题仓库的工作流文件中，确保jobs配置了足够的权限：
```
jobs:
  your-job-name:
    permissions:
      contents: read # 必须配置该权限以读取私有Action仓库
    steps:
      - uses: org_name/repo_name/.github/workflows/action.yml@v1
```
若该仓库的工作流曾手动限制过权限，会导致令牌无法访问私有Action仓库。
检查Action仓库的访问控制列表
进入存放自定义Action的私有仓库，查看Settings > Manage access，确认问题仓库所属的团队/用户已被授予至少Read权限。部分私有仓库可能设置了严格的访问限制，未包含目标仓库的访问主体。
触发工作流的缓存刷新
手动重新运行工作流时选择Re-run jobs with fresh cache，清除可能存在的旧解析缓存，避免因缓存数据异常导致的仓库找不到问题。