GitHub Actions中GITHUB_TOKEN与PAT权限异常排查

问题1：GITHUB_TOKEN查询projectV2返回空节点列表 #

原因 #

仓库默认的GITHUB_TOKEN属于仓库级权限范围，无法访问组织级Project V2资源——组织项目是组织层面的资产，不在仓库令牌的权限覆盖范围内。而个人PAT拥有组织全量权限，因此能正常返回查询结果。

解决步骤 #

• 若你的Project V2是组织级：直接使用已配置好的个人PAT替代GITHUB_TOKEN执行GraphQL查询（你的PAT已具备组织及仓库全量权限，符合要求）。
• 若你的Project V2是仓库级：即使配置了permissions: write-all，仍建议在Workflow中明确添加project: write权限，避免权限覆盖不全的问题，示例配置：

  permissions:
    write-all: true
    project: write # 单独指定确保权限生效
  

问题2：GitHub Actions中推送文件提示无workflows权限 #

原因 #

1. 细粒度PAT权限配置遗漏：细粒度PAT的仓库全量权限不包含workflows细分权限，需单独开启才能操作Workflow相关文件。
2. GITHUB_TOKEN权限覆盖问题：write-all并非完全覆盖所有细分权限，workflows权限需要明确指定才能生效。
3. 推送内容触发校验：若推送的文件包含.github/workflows/目录下的配置文件，必须持有workflows权限才能完成操作；本地act使用本地Git凭据（无权限限制），因此测试正常。

解决步骤 #

1. 补全细粒度PAT权限：
   进入GitHub个人PAT管理页面，找到目标细粒度PAT，将对应仓库的Workflows权限设为Read and write。
2. 调整Workflow权限配置：
   在Workflow中明确指定workflows: write权限，示例：

   permissions:
     write-all: true
     workflows: write # 明确声明该权限
   

3. 验证令牌传递：
   确保推送步骤中正确传递令牌，示例Git推送命令：

   git push https://${{ secrets.YOUR_TOKEN }}@github.com/your-org/your-repo.git main
   

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