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