Servidor de desarrollo

Flask proporciona un comando run para ejecutar la aplicación con un servidor de desarrollo. En modo depuración, este servidor proporciona un depurador interactivo y se recargará cuando se modifique el código.

Advertencia

No utilice el servidor de desarrollo cuando lo despliegue en producción. Está pensado para ser utilizado sólo durante el desarrollo local. No está diseñado para ser particularmente eficiente, estable o seguro.

Ver Despliegue en producción para las opciones de despliegue.

Línea de comandos

El comando CLI flask run es la forma recomendada para ejecutar el servidor de desarrollo. Utilice la opción --app para apuntar a su aplicación, y la opción --debug para activar el modo de depuración.

$ flask --app hello run --debug

Esto habilita el modo de depuración, incluyendo el depurador interactivo y el reloader, y luego inicia el servidor en http://localhost:5000/. Utilice flask run --help para ver las opciones disponibles, y Interfaz de línea de comandos para obtener instrucciones detalladas sobre la configuración y el uso de la CLI.

Dirección ya utilizada

Si otro programa ya está utilizando el puerto 5000, verá un OSError cuando el servidor intente iniciarse. Puede tener uno de los siguientes mensajes:

  • OSError: [Errno 98] Address already in use

  • OSError: [WinError 10013] An attempt was made to access a socket in a way forbidden by its access permissions

Identifique y detenga el otro programa, o utilice flask run --port 5001 para elegir un puerto diferente.

Puedes usar netstat o lsof para identificar qué id de proceso está usando un puerto, y luego usar otras herramientas del sistema operativo para detener ese proceso. El siguiente ejemplo muestra que el proceso 6847 está usando el puerto 5000.

$ netstat -nlp | grep 5000
tcp 0 0 127.0.0.1:5000 0.0.0.0:* LISTEN 6847/python

macOS Monterey and later automatically starts a service that uses port 5000. You can choose to disable this service instead of using a different port by searching for «AirPlay Receiver» in System Preferences and toggling it off.

Errores diferidos en la recarga

Al utilizar el comando flask run con el reloader, el servidor continuará ejecutándose aunque introduzcas errores de sintaxis u otros errores de inicialización en el código. Al acceder al sitio se mostrará el depurador interactivo para el error, en lugar de bloquear el servidor.

Si hay un error de sintaxis cuando se llama a flask run, fallará inmediatamente y mostrará el rastro en lugar de esperar hasta que se acceda al sitio. Esto pretende hacer que los errores sean más visibles al principio, al tiempo que permite al servidor manejar los errores en la recarga.

En Código

The development server can also be started from Python with the Flask.run() method. This method takes arguments similar to the CLI options to control the server. The main difference from the CLI command is that the server will crash if there are errors when reloading. debug=True can be passed to enable debug mode.

Coloque la llamada en un bloque principal, de lo contrario interferirá al intentar importar y ejecutar la aplicación con un servidor de producción más tarde.

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

$ python hello.py