排查 Python 软件包问题

如果您在 Artifact Registry 中管理 Python 软件包时遇到问题,请查阅以下实用的问题排查步骤。

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

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

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

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

如果您重新运行带有标志的命令以获取更详细的消息,则可以获取有关错误的更多信息。

pip

运行带有 --verbose-v 标志的命令。从 pip 21.2 开始,您最多可以使用 3 次此标志来获取额外的输出。例如,若要获取更高级别的调试详细信息,请使用 --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/*