Twine上传GCP Artifact Registry遇413请求实体过大错误

排查与解决步骤 #

• 绕过Cloud Shell代理限制
  Cloud Shell默认启用的代理可能存在请求大小限制，先取消代理环境变量再上传：

  unset HTTP_PROXY HTTPS_PROXY
  

  重新执行上传命令：

  python3 -m twine upload --repository-url https://eu-west3-python.pkg.dev/membrane-94db9/nlpmodels dist/*
  

• 改用gcloud认证方式上传
  依赖gcloud的内置认证配置，避免直接Twine上传的网络问题：

  1. 生成并执行Artifact Registry的Python仓库配置命令：

     gcloud artifacts print-settings python --repository=nlpmodels --location=eu-west3 --project=membrane-94db9
     

  2. 运行输出中的pip配置命令（自动添加认证信息到本地pip配置）
  3. 简化Twine上传命令（无需手动指定仓库地址）：

     python3 -m twine upload dist/*
     

• 确认上传文件范围
  检查dist目录是否包含非包文件，避免误传多余内容：

  ls -lh dist/
  

  仅上传目标包文件，例如：

  python3 -m twine upload --repository-url https://eu-west3-python.pkg.dev/membrane-94db9/nlpmodels dist/your-package-name-1.0.0.tar.gz dist/your_package_name-1.0.0-py3-none-any.whl
  

• 重置Cloud Shell会话
  Cloud Shell网络偶尔会出现异常，重启会话或切换到其他区域的Cloud Shell实例后重试上传。

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