排解 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
Twine

請使用 --verbose 旗標執行指令。例如：

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