GCP Cloud Build突然无法从GitHub Package拉取npm包

可能的原因及解决步骤 #

1. GitHub个人访问令牌（PAT）过期或权限不足 #

• 令牌可能已过有效期，或者被移除了读取私有包的必要权限
• 操作：
  • 登录GitHub账号，进入「Settings > Developer settings > Personal access tokens」
  • 检查对应令牌的状态，确认是否勾选了read:packages和repo权限（私有包读取需要这两个权限）
  • 若令牌过期或权限缺失，重新生成新令牌，更新到Cloud Build的环境变量或.yarnrc配置中

2. Cloud Build的认证配置失效 #

• 存储令牌的环境变量被误删、覆盖，或者.yarnrc里的令牌引用格式错误
• 操作：
  • 打开Cloud Build的构建配置文件（如cloudbuild.yaml），检查是否正确设置了存储GitHub令牌的环境变量
  • 确认.yarnrc中的配置格式正确，例如：

    npmRegistryScopes:
      "@myorg": "https://npm.pkg.github.com"
    npmRegistries:
      "https://npm.pkg.github.com":
        npmAuthToken: "${GITHUB_NPM_TOKEN}"
    

  • 验证环境变量是否在构建过程中正确注入

3. GitHub私有包的访问权限变更 #

• 私有包所属组织/仓库的权限被修改，导致令牌对应的账号无法读取包资源
• 操作：
  • 进入GitHub的私有包页面，检查「Access control」设置，确认令牌所属的账号或团队拥有「Read」权限

4. Yarn缓存留存旧认证信息 #

• Cloud Build的缓存可能保留了失效的认证数据，导致请求时使用旧信息触发403
• 操作：
  • 在Cloud Build的yarn install步骤前添加yarn cache clean命令，清理旧缓存
  • 或者在构建配置中禁用该步骤的缓存，强制重新拉取依赖

5. GitHub服务临时异常 #

• GitHub的npm包仓库可能存在临时限流或故障
• 操作：
  • 检查GitHub官方状态公告，确认相关服务是否正常
  • 等待一段时间后重新触发构建

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