GitHub Actions默认GITHUB_TOKEN无法访问ProjectV2求助

报错原因 #

默认的${{ secrets.GITHUB_TOKEN }}是仓库级权限令牌，仅拥有当前仓库内的操作权限，无法访问组织级的Project V2资源。哪怕开启了仓库的读写权限，令牌的权限边界仍限制在仓库范围内，跨组织的项目资源不在其访问范围内。而个人访问令牌（PAT）如果配置了project类权限且属于组织成员，就能突破仓库边界访问组织项目，因此可以正常运行。

解决方法 #

要使用默认GITHUB_TOKEN完成操作，需要显式赋予其访问组织项目的权限，有两种实现方式：

方式一：在Workflow中单独声明权限（推荐） #

在你的Workflow的add-to-project任务下添加permissions配置，明确授予访问组织项目的权限，同时保留必要的仓库操作权限：

on:
  workflow_call:
  pull_request:
    types:
      - opened
      - synchronize
      - closed
jobs:
  add-to-project:
    runs-on: ubuntu-latest
    # 添加权限声明
    permissions:
      contents: read
      pull-requests: write
      projects: write  # 关键：赋予组织项目的写入权限
    steps:
      - name: Add PR to Project
        uses: actions/add-to-project@v0.5.0
        with:
          project-url: https://github.com/orgs/<org_name_here>/projects/2
          github-token: ${{ secrets.GITHUB_TOKEN }}

方式二：调整仓库Actions默认权限 #

如果希望仓库内所有Workflow都拥有该权限，可以修改仓库全局设置：

1. 进入仓库的「Settings」→「Actions」→「General」页面
2. 在「Workflow permissions」区域，选择「Read and write permissions」
3. 若需要，勾选「Allow GitHub Actions to create and approve pull requests」

注意：这种方式会给所有Workflow授予较宽权限，存在过度授权风险，优先推荐方式一。

额外注意事项 #

• 确认组织未通过权限设置禁用仓库令牌访问组织项目
• 确保目标项目是Project V2版本（你的URL格式符合要求，已确认）

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