如何验证GitHub个人访问令牌有效性及排查Renovate Action认证失败

一、本地用curl验证 #

1. 先确认令牌本身有效 #

执行以下命令（把YOUR_PAT替换成你的令牌字符串）：

curl -H "Authorization: token YOUR_PAT" https://api.github.com/user

如果返回包含你GitHub用户名、邮箱等信息的JSON，说明令牌本身没问题；如果返回401 Unauthorized，那令牌要么无效、要么过期，或者创建时没勾选任何权限。

2. 验证目标仓库的维护权限 #

针对你的目标仓库myrepo/myrepo，执行：

curl -H "Authorization: token YOUR_PAT" https://api.github.com/repos/myrepo/myrepo/collaborators/你的GitHub用户名/permission

重点看返回结果里的permission字段：

• 如果是admin、maintain或write，说明令牌拥有该仓库的维护权限；
• 如果是read或none，那就是权限不够，得重新生成令牌并确保勾选完整的repo权限组。

二、在GitHub Action中验证 #

在你的Renovate Bot工作流里，添加一个前置步骤来验证令牌权限，比如：

jobs:
  renovate:
    runs-on: ubuntu-latest
    steps:
      - name: Validate PAT permissions
        run: |
          # 用curl检查仓库权限
          RESPONSE=$(curl -s -H "Authorization: token ${{ secrets.YOUR_SECRET_NAME }}" https://api.github.com/repos/myrepo/myrepo)
          echo "仓库信息：$(echo $RESPONSE | jq '.name')"
          echo "令牌权限：$(echo $RESPONSE | jq '.permissions')"
          
          # 可选：用GitHub CLI验证（需要先安装gh）
          sudo apt-get install -y gh
          echo "${{ secrets.YOUR_SECRET_NAME }}" | gh auth login --with-token
          gh repo view myrepo/myrepo --json permissions
        env:
          GITHUB_TOKEN: ${{ secrets.YOUR_SECRET_NAME }}
      
      # 原来的Renovate步骤
      - name: Run Renovate
        uses: renovatebot/github-action@v39
        with:
          token: ${{ secrets.YOUR_SECRET_NAME }}

把YOUR_SECRET_NAME替换成你在仓库Secrets里设置的令牌名称。运行这个工作流后，查看Validate PAT permissions步骤的输出：

• 如果permissions里的write或maintain为true，说明权限正常；
• 如果返回401或权限不足，检查Secret是否正确配置、令牌是否有完整repo权限。

额外排查点 #

• 确认创建令牌时，repo权限组的所有子项都被勾选（完整repo权限包含仓库读写、PR、状态等所有权限）；
• 检查令牌是否过期（创建时默认有效期是30天，可设置为永久）；
• 确认Action中引用的Secret名称和仓库Secrets里的名称完全一致，没有拼写错误。

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