排查 Python 软件包问题

了解您在 Artifact Registry 中管理 Python 软件包时遇到问题时可能有用的问题排查步骤。

如需了解适用于所有工件格式的问题,请参阅常规问题排查

上传和下载软件包时遇到问题

pip 和 Twine 等工具会返回 HTTP 错误代码。您可能会遇到的一些错误代码:

  • 403 - 身份验证问题,可能是因为缺少执行此操作的权限
  • 404 - 找不到软件包。验证路径和软件包名称是否正确。如果您要下载软件包,请列出代码库内容,以确认软件包位于代码库中

如果您使用带有更详细消息的标志重新运行该命令,可以详细了解此错误。

pip

运行带有 --verbose-v 标志的命令。从 pip 21.2 开始,您最多可以使用该标志三次以产生额外的输出。例如,如需获取下一级别的调试详情,请使用 --verbose --verbose-vv。例如:

pip install -vv --index-url https://us-east1-python.pkg.dev/my-project/my-repo/simple/ my-package
绞盘

运行带有 --verbose 标志的命令。例如:

twine upload --repository-url https://us-east1-python.pkg.dev/my-project/my-repo/ --verbose dist/*