Soluciona problemas relacionados con paquetes de Python
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Obtén información sobre los pasos para solucionar problemas que pueden servirte si tienes dificultades para administrar paquetes de Python en Artifact Registry.
Las herramientas como pip y Twine muestran códigos de error HTTP. Estos son algunos códigos de error que puedes encontrar:
403: Problema de autenticación, posiblemente causado por la falta de permisos para realizar la operación.
404: No se encontró el paquete. Verifica que la ruta de acceso y el nombre del paquete sean correctos.
Si descargas un paquete, enumera el contenido del repositorio para confirmar que el paquete esté en él.
Puedes obtener más información sobre el error si vuelves a ejecutar el comando con una marca para obtener mensajes más detallados.
pip
Ejecuta el comando con la marca --verbose o -v. A partir de pip 21.2, puedes usar la marca hasta tres veces para obtener un resultado adicional. Por ejemplo, para obtener el siguiente nivel de detalle de depuración, usa --verbose --verbose o -vv. Por ejemplo:
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-04 (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/*"]]