使用actions/checkout@v3拉取私有组织仓库失败的问题

针对你遇到的私有仓库拉取失败问题，可从以下几个方向排查修复：

1. 修正复用工作流的引用语法 #

你当前用./reusable-actions/BuildNET.yml@main引用本地拉取的工作流，这里的@main是远程工作流专属的引用语法，本地路径引用不需要加分支后缀，否则会被系统误判为远程资源。直接修改为：

- uses: ./reusable-actions/BuildNET.yml
  with:
    secrets: inherit

2. 确认令牌的实际权限与生效范围 #

• 即便你给了令牌全权限，也要检查是否勾选了repo核心权限（私有仓库拉取必须依赖这个权限）。
• 组织级密钥需要确保当前流水线所在仓库已被授权使用该密钥，可在仓库设置的「Actions」→「Secrets and variables」→「Actions」里确认组织密钥是否可见。
• 若使用的是个人访问令牌（PAT），要确认令牌的作用域包含目标私有仓库所在组织，且未过期。

3. 核对仓库路径与分支的准确性 #

• 检查<ORGNAME>/<REPONAME>的拼写（包括大小写，GitHub仓库名区分大小写），确保与实际地址完全一致。
• 在actions/checkout步骤中明确指定拉取分支，避免默认分支不一致的问题：

- uses: actions/checkout@v3
  with: 
    repository: <ORGNAME>/<REPONAME>
    token: ${{ secrets.TOKEN }}
    path: reusable-actions
    ref: main

4. 验证令牌的访问有效性 #

添加测试步骤直接用令牌克隆目标仓库，快速定位权限问题：

- name: 验证令牌权限
  run: |
    git clone https://${{ secrets.TOKEN }}@github.com/<ORGNAME>/<REPONAME>.git test-repo
    ls test-repo

如果此步骤失败，说明令牌确实无访问权限，需重新生成并配置正确权限。

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