El Proyecto | Sobre nosotros | Contribuir | Donaciones | Licencia

HOME

En este tema, aprenderemos cómo manejar errores en Flask de manera efectiva. El manejo adecuado de errores es crucial para crear aplicaciones web robustas y amigables para el usuario. Veremos cómo capturar y gestionar diferentes tipos de errores, cómo personalizar las respuestas de error y cómo registrar errores para su posterior análisis.

Conceptos Clave

Errores y Excepciones en Flask: Entender los diferentes tipos de errores que pueden ocurrir en una aplicación Flask.
Manejo de Errores con Decoradores: Uso de decoradores para capturar y manejar errores específicos.
Páginas de Error Personalizadas: Crear páginas de error personalizadas para mejorar la experiencia del usuario.
Registro de Errores: Registrar errores para su análisis y depuración.

Errores y Excepciones en Flask

Flask utiliza el sistema de manejo de excepciones de Python para capturar y gestionar errores. Algunos errores comunes incluyen:

404 Not Found: Ocurre cuando una URL solicitada no existe.
500 Internal Server Error: Ocurre cuando hay un error en el servidor.
403 Forbidden: Ocurre cuando el acceso a un recurso está prohibido.

Ejemplo de Error 404

from flask import Flask, abort

app = Flask(__name__)

@app.route('/<name>')
def hello(name):
    if name != 'valid_user':
        abort(404)
    return f'Hello, {name}!'

if __name__ == '__main__':
    app.run(debug=True)

En este ejemplo, si el nombre no es 'valid_user', se genera un error 404.

Manejo de Errores con Decoradores

Flask proporciona un decorador @app.errorhandler para manejar errores específicos. Puedes usar este decorador para definir funciones que se ejecutarán cuando ocurra un error específico.

Ejemplo de Manejo de Error 404

@app.errorhandler(404)
def page_not_found(e):
    return "Sorry, the page you are looking for does not exist.", 404

En este ejemplo, cuando ocurre un error 404, se devuelve un mensaje personalizado.

Páginas de Error Personalizadas

Para mejorar la experiencia del usuario, puedes crear páginas de error personalizadas utilizando plantillas.

Ejemplo de Página de Error Personalizada

Crear una plantilla de error: templates/404.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Page Not Found</title>
</head>
<body>
    <h1>404 - Page Not Found</h1>
    <p>Sorry, the page you are looking for does not exist.</p>
</body>
</html>

Modificar el manejador de errores para renderizar la plantilla:

from flask import render_template

@app.errorhandler(404)
def page_not_found(e):
    return render_template('404.html'), 404

Registro de Errores

Registrar errores es importante para la depuración y el mantenimiento de la aplicación. Flask permite registrar errores utilizando el módulo logging de Python.

Ejemplo de Registro de Errores

import logging
from logging.handlers import RotatingFileHandler

if not app.debug:
    handler = RotatingFileHandler('error.log', maxBytes=10000, backupCount=1)
    handler.setLevel(logging.ERROR)
    app.logger.addHandler(handler)

@app.errorhandler(500)
def internal_error(error):
    app.logger.error(f'Server Error: {error}, route: {request.url}')
    return "500 error", 500

En este ejemplo, los errores 500 se registran en un archivo error.log.

Ejercicio Práctico

Ejercicio 1: Manejo de Error 403

Objetivo: Crear un manejador de errores para el error 403 y una página de error personalizada.
Instrucciones:
- Crea una plantilla 403.html en el directorio templates.
- Define un manejador de errores para el error 403 que renderice la plantilla 403.html.

Solución

Crear la plantilla 403.html:

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Forbidden</title>
</head>
<body>
    <h1>403 - Forbidden</h1>
    <p>You do not have permission to access this resource.</p>
</body>
</html>

Definir el manejador de errores:

@app.errorhandler(403)
def forbidden(e):
    return render_template('403.html'), 403

Conclusión

En esta sección, hemos aprendido cómo manejar errores en Flask utilizando decoradores, cómo crear páginas de error personalizadas y cómo registrar errores para su análisis. El manejo adecuado de errores es esencial para crear aplicaciones web robustas y amigables para el usuario. En el próximo tema, exploraremos cómo crear páginas de error personalizadas en mayor detalle.

Manejo de Errores

Conceptos Clave

Errores y Excepciones en Flask

Ejemplo de Error 404

Manejo de Errores con Decoradores

Ejemplo de Manejo de Error 404

Páginas de Error Personalizadas

Ejemplo de Página de Error Personalizada

Registro de Errores

Ejemplo de Registro de Errores

Ejercicio Práctico

Ejercicio 1: Manejo de Error 403

Solución

Conclusión

Curso de Desarrollo Web con Flask

Módulo 1: Introducción a Flask

Módulo 2: Conceptos Básicos de Flask

Módulo 3: Formularios y Entrada de Usuario

Módulo 4: Integración de Bases de Datos

Módulo 5: Autenticación de Usuarios

Módulo 6: Conceptos Avanzados de Flask

Módulo 7: APIs RESTful con Flask

Módulo 8: Despliegue y Producción

Módulo 9: Pruebas y Mejores Prácticas

Módulo 10: Extensiones y Ecosistema de Flask