无法向GCP Artifact Registry推送Docker镜像的认证问题求助

排查与修复步骤 #

1. 确认当前活跃gcloud账号 #

先检查终端当前使用的gcloud账号是否为有权限的账号：

gcloud config get-value account

若输出不是user123@gmail.com或sa123@project-id.iam.gserviceaccount.com，切换到目标账号：

• 切换用户账号：

gcloud config set account user123@gmail.com

• 切换服务账号（需提前下载密钥文件）：

gcloud auth activate-service-account sa123@project-id.iam.gserviceaccount.com --key-file=/path/to/your/service-account-key.json

2. 重置Docker凭证助手配置 #

凭证缓存异常可能导致认证失效，先移除旧配置再重新生成：

gcloud auth configure-docker asia-southeast1-docker.pkg.dev --remove
gcloud auth configure-docker asia-southeast1-docker.pkg.dev

修改后检查~/.docker/config.json，确保credHelpers仅保留"asia-southeast1-docker.pkg.dev": "gcloud"，且auths字段为空。

3. 清除凭证缓存并重启服务 #

• 清除gcloud所有缓存凭证：

gcloud auth revoke --all

之后重新登录用户账号或激活服务账号。

• 临时禁用Docker Desktop凭证存储（避免冲突）：
  编辑~/.docker/config.json，将"credsStore": "desktop"改为"credsStore": ""，保存后重启Docker Desktop或Docker服务。

4. 验证账号权限有效性 #

检查账号是否拥有目标仓库的上传权限：

gcloud artifacts repositories get-iam-policy projects/project-id/locations/asia-southeast1/repositories/repository-name

确认输出中包含user123@gmail.com（绑定Owner角色）或sa123@project-id.iam.gserviceaccount.com（绑定Artifact Registry Administrator角色）。

也可直接测试权限：

gcloud auth test artifactregistry.repositories.uploadArtifacts --resource=projects/project-id/locations/asia-southeast1/repositories/repository-name

返回Permissions allowed则权限正常。

5. 确认镜像标签格式正确 #

确保构建时使用的IMAGE_URL完全符合格式：

asia-southeast1-docker.pkg.dev/project-id/repository-name/[image-name]:[tag]

标签错误会导致请求路由到不存在的资源，触发权限报错。

6. 检查仓库状态 #

确认仓库已正常就绪：

gcloud artifacts repositories describe projects/project-id/locations/asia-southeast1/repositories/repository-name

查看输出中state字段是否为ACTIVE。

内容的提问来源于stack exchange，提问作者Jun Wen Soh