GitHub Actions中用GitHub CLI管理仓库配置遇403权限问题

1. 给工作流配置administration: write权限 #

GitHub Actions默认的GITHUB_TOKEN权限非常有限，仅支持基础的仓库内容读取。要修改仓库全局设置（比如禁用Wiki、调整Issue功能等），必须显式授予管理类权限。

在你的工作流YAML文件中添加这段配置（可放在全局范围或具体Job下）：

permissions:
  administration: write

你之前设置的contents: write仅能用于修改仓库内的文件内容，完全无法操作仓库本身的全局配置，这就是触发403错误的核心原因。

2. 确认令牌的权限范围 #

• 若使用GitHub Actions默认的GITHUB_TOKEN，完成上述权限配置即可；
• 若你用自定义的Personal Access Token（PAT）实现跨仓库管理，这个PAT必须勾选repo权限（包含修改仓库设置的能力），且持有该PAT的账号在目标仓库需拥有管理员权限。

3. 验证命令的权限适配 #

不管是gh repo edit还是gh api的PATCH请求，修改仓库配置（如has_wiki、has_issues这类字段）都依赖管理权限而非内容读写权限。举个可用的gh api命令示例：

gh api -X PATCH /repos/${{ github.repository_owner }}/${{ github.repository }} -f has_wiki=false

只要工作流配置了administration: write权限，该命令就能正常执行。

跨仓库管理的额外要求 #

如果你的工作流在A仓库，需要修改B、C等其他仓库的设置，默认的GITHUB_TOKEN会失效——它仅对当前仓库有效。此时必须使用满足要求的PAT，且目标仓库需允许该PAT持有者拥有管理员权限。

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