开发服务器¶

Flask 提供了一个 run 命令，该命令用来以开发服务器运行应用。在调试模式模式下，开发服务器提供交互式调试器，并在代码更改时重新加载。

Warning

生产环境不要使用开发服务器。开发服务器仅供在本地开发期间使用，它在效率、稳定或安全方面是缺失的。

有关部署选项，请参阅生产部署。

通过命令行使用开发服务器¶

推荐使用 flask run 命令行脚本运行开发服务器。使用 --app 选项指向你的应用，使用 --debug 选项打开调试模式。

$ flask --app hello run --debug

这样就启动了开发环境，包括交互调试器和重载器，并在 http://localhost:5000/ 提供服务。使用 flask run --help 命令可以查看可用的选项，命令行接口提供了关于配置和使用 CLI 的详细介绍。

如果其他程序已经占用了 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 来找到占用端口的进程，并使用系统工具来停止该进程。下面的例子展示进程 id 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 端口的“接力”服务。你可以通过变更端口来避免冲突，也可以停用这个服务。停用的方法是：在系统设置中搜索“接力”，然后停用它。

当重加载器使用 flask run 命令时，服务器将持续运行。哪怕您在代码中引入了语法错误或其他初始化错误。访问网站时会交互式调试器中显示错误，而不是使服务器崩溃。

如果在调用 flask run 时已经存在语法错误，它将立即失败并显示回溯，而不是等到网站被访问。这是为了使错误最初更明显同时仍然允许服务器在重新加载时处理错误。

开发服务器也可以在 Python 中通过 Flask.run() 方法启动。这个方法接受的参数与 CLI 的相似。主要的不同是重新加载时如果有错误，服务器会崩溃。 debug=True 参数可以开启调试器。

应当把调用放在 main 代码块中，否则当以后在生产环境中导入和运行应用时会产生干扰。

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

$ python hello.py