使用gcloud令牌连接Artifact Registry失败无返回，请求排查

我尝试通过gcloud令牌连接Google Artifact Registry，但执行helm登录命令后无任何返回结果，需手动中断。已确认服务账号cicd@XXXX.iam.gserviceaccount.com拥有roles/artifactregistry.admin和roles/owner权限，执行了激活服务账号、设置环境变量、通过gcloud令牌登录Helm仓库的操作，仍未解决问题。

执行的命令及输出如下：

# 验证服务账号权限
gcloud projects get-iam-policy XXXX  \
  --flatten="bindings[].members" \
  --format='table(bindings.role)' \
  --filter="bindings.members:cicd@XXXX.iam.gserviceaccount.com"
# 输出结果
ROLE
roles/artifactregistry.admin
roles/owner

# 激活服务账号
gcloud auth activate-service-account cicd@XXX.gserviceaccount.com --key-file=key.json --project=XXXXX

# 设置环境变量并执行helm登录
export GOOGLE_APPLICATION_CREDENTIALS=key.json
gcloud auth application-default print-access-token | helm registry login -u oauth2accesstoken --password-stdin https://europe-west3-docker.pkg.dev
# 命令无响应，手动中断 ^C

可能的原因及解决方法 #

1. 网络/代理阻塞 #

命令无响应大概率是网络层面的问题：

• 先测试连通性：执行curl -v https://europe-west3-docker.pkg.dev，看是否能正常建立连接
• 若在企业内网，需给gcloud和helm配置代理：

  # 配置gcloud代理
  gcloud config set proxy/type http
  gcloud config set proxy/address <你的代理地址>
  gcloud config set proxy/port <代理端口>
  
  # 配置helm代理环境变量
  export HTTP_PROXY=http://<你的代理地址>:<端口>
  export HTTPS_PROXY=http://<你的代理地址>:<端口>
  

2. 令牌获取异常 #

单独测试令牌生成：

• 执行gcloud auth application-default print-access-token，看是否能快速输出有效令牌
  • 如果这个命令也卡住，说明应用默认凭据配置有问题，重新生成服务账号密钥文件再试
  • 如果能正常输出令牌，手动复制令牌执行登录，排除管道传递问题：

    helm registry login -u oauth2accesstoken --password <复制的令牌内容> https://europe-west3-docker.pkg.dev
    

3. Helm版本兼容性问题 #

Artifact Registry对Helm版本有要求（建议v3.8及以上）：

• 执行helm version检查版本，若版本过低，升级到最新稳定版

4. 密钥文件有效性问题 #

• 检查key.json内容是否完整、格式正确，确认该密钥属于目标服务账号cicd@XXX.gserviceaccount.com，且关联的项目为XXXXX

5. 仓库地址正确性 #

确认项目在europe-west3区域确实存在对应的Helm仓库，避免区域或地址拼写错误

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