Ferramentas como o pip e o Twine devolvem códigos de erro HTTP. Alguns códigos de erro que pode
encontrar:
403 – Problema de autenticação, possivelmente causado pela falta de autorizações para realizar a operação.
404 – Pacote não encontrado. Verifique se o caminho e o nome do pacote estão corretos.
Se estiver a transferir um pacote, liste o conteúdo do repositório para confirmar que o pacote está no repositório
Pode obter mais informações sobre o erro se executar novamente o comando com uma flag para mensagens mais detalhadas.
pip
Execute o comando com a flag --verbose ou -v. A partir do pip 21.2,
pode usar a flag até três vezes para obter resultados adicionais. Por exemplo, para obter o nível seguinte de detalhes de depuração, use --verbose --verbose ou -vv. Por exemplo:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-20 UTC."],[[["\u003cp\u003eThis guide covers troubleshooting steps for managing Python packages in Artifact Registry.\u003c/p\u003e\n"],["\u003cp\u003eCommon HTTP error codes such as 403 (authentication issue) and 404 (package not found) are explained.\u003c/p\u003e\n"],["\u003cp\u003eYou can get more detailed error messages by using the \u003ccode\u003e--verbose\u003c/code\u003e or \u003ccode\u003e-v\u003c/code\u003e flag with pip commands, or \u003ccode\u003e--verbose\u003c/code\u003e with Twine commands.\u003c/p\u003e\n"],["\u003cp\u003eThe document suggests you can confirm a package is in a repository by listing the repositories content if you are receiving a 404 error while downloading.\u003c/p\u003e\n"]]],[],null,["# Troubleshoot Python packages issues\n\nLearn about troubleshooting steps that you might find helpful if you run into\nproblems managing Python packages in Artifact Registry.\n\nFor issues that apply to all artifact formats, see\n[General troubleshooting](/artifact-registry/docs/troubleshooting).\n\nIssues uploading and downloading packages\n-----------------------------------------\n\nTools such as pip and Twine return HTTP error codes. Some error codes you might\nencounter:\n\n- 403 - Authentication issue, possibly caused by lack of [permissions](/artifact-registry/docs/access-control#roles) to perform the operation.\n- 404 - Package not found. Verify that the path and package name are correct. If you are downloading a package, [list](/artifact-registry/docs/python/manage-packages#list) the repository contents to confirm that the package is in the repository\n\nYou can get more information about the error if you rerun the command with a\nflag for more detailed messages.\n\npip\n\n: Run the command with the `--verbose` or `-v` flag. Starting with pip 21.2,\n you can use the flag up to three times for extra output. For example\n to get the next level of debugging detail, use `--verbose --verbose` or\n `-vv`. For example:\n\n pip install -vv --index-url https://us-east1-python.pkg.dev/my-project/my-repo/simple/ my-package\n\nTwine\n\n: Run the command with the `--verbose` flag. For example:\n\n twine upload --repository-url https://us-east1-python.pkg.dev/my-project/my-repo/ --verbose dist/*"]]
