Сервер разработки

Flask предоставляет команду run для запуска приложения с сервером разработки. В режиме отладки этот сервер предоставляет интерактивный отладчик и будет перезагружаться при изменении кода.

Предупреждение

Не используйте сервер разработки при развертывании в продакшене. Он предназначен только для использования во время локальной разработки. Он не предназначен для высокой эффективности, стабильности или безопасности.

См. Развертывание в продакшене для вариантов развертывания.

Командная строка

Рекомендуемый способ запуска сервера разработки — команда flask run командной строки. Используйте опцию --app для указания вашего приложения и опцию --debug для включения режима отладки.

$ flask --app hello run --debug

Это включает режим отладки, включая интерактивный отладчик и перезагрузчик, а затем запускает сервер по адресу http://localhost:5000/. Используйте flask run --help для просмотра доступных опций и Интерфейс командной строки для получения подробных инструкций по настройке и использованию командной строки.

Адрес уже используется

Если другой процесс уже использует порт 5000, при попытке запуска сервера вы увидите OSError. Сообщение может содержать одну из следующих фраз:

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

Определите и остановите другой процесс или используйте flask run --port 5001 для выбора другого порта.

Вы можете использовать netstat или lsof для определения идентификатора процесса, использующего порт, а затем использовать другие инструменты операционной системы для остановки этого процесса. Приведенный ниже пример показывает, что процесс с идентификатором 6847 использует порт 5000.

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

$ lsof -P -i :5000
Python 6847 IPv4 TCP localhost:5000 (LISTEN)

> netstat -ano | findstr 5000
TCP 127.0.0.1:5000 0.0.0.0:0 LISTENING 6847

macOS Monterey и более поздние версии автоматически запускают службу, использующую порт 5000. Чтобы отключить службу, перейдите в «Системные настройки», «Общие», и отключите «Приёмник AirPlay».

Отложенные ошибки при перезагрузке

При использовании команды flask run с перезагрузчиком сервер будет продолжать работу, даже если вы введёте синтаксические ошибки или другие ошибки инициализации в код. При доступе к сайту будет показан интерактивный отладчик для ошибки, а не сбой сервера.

Если синтаксическая ошибка уже присутствует при вызове flask run, она будет завершена немедленно, и будет показан стек вызовов, а не ожидание до доступа к сайту. Это сделано для того, чтобы ошибки были более заметны изначально, всё ещё позволяя серверу обрабатывать ошибки при перезагрузке.

В коде

Сервер разработки также может быть запущен из Python с помощью метода Flask.run(). Этот метод принимает аргументы, аналогичные опциям командной строки, для управления сервером. Основное различие с командой командной строки заключается в том, что сервер завершится ошибкой, если при перезагрузке возникнут ошибки. debug=True может быть передано для включения режима отладки.

Разместите вызов в блоке main, иначе он будет мешать при попытке импортировать и запустить приложение с сервером продакшена позже.

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

$ python hello.py