推送Docker镜像至GCR遇401未授权错误，MacBook专属问题求助

算力阿峰

2026-8-12

解决方案

检查Docker凭证助手配置
打开~/.docker/config.json文件，确认包含以下条目：
```
"credHelpers": {
  "gcr.io": "gcloud",
  "us.gcr.io": "gcloud",
  "eu.gcr.io": "gcloud",
  "asia.gcr.io": "gcloud"
}
```
如果没有，重新执行gcloud auth configure-docker。若存在docker-credential-desktop相关的配置条目，建议删除以避免冲突。
重置gcloud认证状态
1. 撤销所有已登录账号：gcloud auth revoke --all
2. 重新用公司邮箱登录：gcloud auth login
3. 再次配置Docker凭证：gcloud auth configure-docker
确认gcloud项目与权限设置
1. 检查当前gcloud关联项目是否正确：gcloud config get-value project，若不正确，执行gcloud config set project <你的项目ID>
2. 验证账号对目标项目的权限：gcloud projects get-iam-policy <你的项目ID> --filter="bindings.members:user:<你的公司邮箱>"，确保账号拥有storage.admin或storage.objectCreator这类可推送镜像的权限。
排查版本兼容性与工具完整性
1. 更新gcloud到最新版本：gcloud components update，旧版本的凭证助手可能与Docker存在兼容性问题
2. 检查gcloud凭证助手文件是否存在且可执行：ls -l ~/.config/gcloud/docker-credential-gcloud，若缺失，重新安装gcloud组件
检查环境变量干扰
执行echo $DOCKER_CONFIG，如果输出非空，说明Docker读取的配置文件不在默认路径~/.docker/config.json，需取消该环境变量，或在对应路径下配置gcloud凭证助手。
测试基础连接
尝试拉取一个公开GCR镜像验证认证是否正常：gcloud docker -- pull gcr.io/google-containers/busybox，若拉取失败，说明核心认证存在问题；若成功，再聚焦推送环节的配置细节。