Github仅支持Personal Access Tokens后GCP Build Trigger触发失败如何重新认证

前置准备：生成符合权限要求的GitHub个人访问令牌（PAT） #

• 登录GitHub账号，依次进入Settings → Developer settings → Personal access tokens → Tokens (classic)
• 点击Generate new token，按需配置过期时间后，勾选以下必要权限：
  • 完整的repo权限（含repo:status、repo_deployment等所有子项）
  • admin:repo_hook的读写权限
  • read:user、user:email基础用户信息读取权限
• 生成令牌后复制保存PAT字符串
  注意：PAT仅会在生成时展示一次，关闭页面后无法二次查看，请提前妥善留存

步骤1：更新GCP中存储的GitHub认证凭证 #

你之前重新关联仓库未生效，是因为GCP保留的旧认证凭证未更新，需先修改连接级别的凭证：

• 打开GCP控制台，进入Cloud Build → Triggers页面，点击顶部的Manage repositories标签
• 找到你绑定的GitHub仓库对应的连接（Connection），点击右侧更多操作按钮，选择Edit connection
• 认证方式选择Personal access token，粘贴你刚生成的新PAT后保存配置

步骤2：校验GitHub仓库Webhook配置 #

• 进入GitHub对应代码仓库的Settings → Webhooks页面，找到GCP Cloud Build对应的webhook
• 查看Recent Deliveries列表，如果有近期推送失败的记录，点击Redeliver测试连通性
• 如果未找到对应GCP webhook，回到GCP的Manage repositories页面，选中对应仓库点击Reconnect，会自动重新创建合规的webhook

步骤3：测试触发逻辑 #

• 向main分支提交一次测试推送，回到GCP Cloud Build的Triggers页面，确认是否有新的构建任务启动
• 如果仍未触发，进入对应触发器的详情页，检查分支过滤规则是否匹配main分支，触发事件是否勾选了Push to a branch

额外排查点 #

• 确认GCP项目的Cloud Build默认服务账号（格式为[项目编号]@cloudbuild.gserviceaccount.com）未被禁用，且持有Cloud Build Service Agent角色
• 确认生成的PAT未被GitHub安全策略拦截、未超出过期时间

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