排查 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/*