Actualmente actualizando a la última versión de Django tiene varios beneficios:
Nuevos características y mejoras se agregan.
Problemas resueltos.
Versiones antiguas de Django dejarán de recibir actualizaciones de seguridad eventualmente. (ver Versiones soportadas).
Actualizando cada vez que esté disponible una nueva versión de Django, las futuras actualizaciones serán menos dolorosas ya que mantendrás tu base de código al día.
Herramientas para ayudar con las actualizaciones de versión
Django tiene un ecosistema vibrante. Hay ayudantes de actualización automatizados destacados en la página Ecosistema Comunitario.
Aquí tienes algunas cosas que debes tener en cuenta para ayudar a que el proceso de actualización sea lo más suave posible.
Si es la primera vez que haces una actualización, es útil leer el guía sobre los diferentes procesos de lanzamiento .
Después de eso, deberías familiarizarte con los cambios que se realizaron en la nueva versión(s) de Django:
Lee las notas de lanzamiento para cada “lanzamiento final” desde la versión de Django actualizada hasta la versión a la que planeas actualizar.
Mira el cronograma de desprecación para las versiones relevantes.
Presta especial atención a los cambios incompatibles con lo anterior para obtener una idea clara de qué se necesitará para un upgrade exitoso.
Si estás actualizando a través de más de una versión de características (por ejemplo, 2.0 a 2.2), es usualmente más fácil actualizar incrementando cada versión de características (2.0 a 2.1 a 2.2) en lugar de hacer todos los cambios para cada versión de características al mismo tiempo. Para cada versión de características, utiliza la última versión de parche (por ejemplo, para 2.1, utilice 2.1.15).
Se recomienda el mismo enfoque de actualización incremental cuando se actualiza desde una LTS a la siguiente.
En la mayoría de los casos será necesario actualizar a la última versión de tus dependencias relacionadas con Django también. Si la versión de Django fue lanzada recientemente o si algunas de tus dependencias no están bien mantenidas, algunas de tus dependencias pueden no apoyar aún la nueva versión de Django. En estos casos puede que debas esperar hasta que se publiquen nuevas versiones de tus dependencias.
Antes de actualizar, es una buena idea resolver cualquier advertencia de desprecación generada por tu proyecto mientras utilizabas la versión actualizada de Django. Corrigiendo estas advertencias antes de actualizar asegura que estás informado sobre áreas del código que necesitan ser alteradas.
Los textos traducidos manteniendo todas las etiquetas intactas son:
$ python -Wa manage.py test
Si no estás utilizando el ejecutor de pruebas de Django, es posible que debas asegurarte también de que cualquier salida en consola no sea capturada lo que ocultaría las advertencias de desuso. Por ejemplo, si utilizas pytest:
$ PYTHONWARNINGS=always pytest tests --capture=no
Resuelve cualquier advertencia de desuso con tu versión actual de Django antes de continuar el proceso de actualización.
Las aplicaciones de terceros pueden utilizar APIs de desuso para apoyar múltiples versiones de Django, por lo que las advertencias de desuso en paquetes instalados no necesariamente indican un problema. Si un paquete no soporta la versión más reciente de Django, considera abrir una incidencia o enviar una solicitud de pull.
Una vez que estés listo, es hora de instalar la nueva versión de Django. Si estás utilizando un entorno virtual y se trata de una actualización mayor, podrías querer configurar un nuevo entorno con todas las dependencias.
Si instalaste Django con pip, puedes utilizar la bandera --upgrade o -U:
$ python -m pip install -U Django
Cuando el nuevo entorno esté configurado, ejecuta la suite de pruebas completa para tu aplicación. De nuevo, es útil activar las advertencias de desuso para que se muestren en la salida de las pruebas (también puedes utilizar la bandera si ejecutas manualmente tu app utilizando manage.py runserver):
$ python -Wa manage.py test
Después de haber ejecutado las pruebas, corrige cualquier falla. Mientras tengas los notas de lanzamiento frescos en mente, también podría ser un buen momento para aprovechar nuevas características de Django refactorizando tu código para eliminar cualquier advertencia de desuso.
Cuando estés lo suficientemente seguro de que tu app funciona con la nueva versión de Django, estarás listo para ir adelante y desplegar tu proyecto de Django actualizado.
Si estás utilizando la caché proporcionada por Django, debes considerar borrar tu caché después de actualizar. De lo contrario, podrías encontrarte con problemas, por ejemplo, si estás cacheando objetos serializados como estos objetos no están garantizados para ser compatibles con la serialización a través de versiones de Django. Un caso pasado de incompatibilidad fue cacheando objetos HttpResponse serializados directamente o indirectamente mediante el decorador de función cache_page().
may 31, 2026