Flask作为轻量级的Python Web框架,在开发调试过程中经常会出现404错误,其中很大一部分原因和IP地址、端口的配置有关。很多开发者在启动应用后,使用错误的地址访问就会出现页面不存在的提示。
Flask默认启动配置说明
Flask应用默认启动时,监听的IP地址是127.0.0.1,端口是5000,只有本地设备可以通过这个地址访问应用。如果开发者尝试用其他IP地址或者端口访问,就会触发404错误。
基础的Flask启动代码如下:
from flask import Flask
app = Flask(__name__)
@app.route('/')
def index():
return 'Hello Flask'
if __name__ == '__main__':
# 默认配置,仅本地可访问
app.run()
IP地址配置相关问题与解决方法
仅本地可访问导致的404
如果需要在局域网内的其他设备访问Flask应用,就需要把IP地址配置为0.0.0.0,这样应用会监听所有可用的网络接口。
修改后的启动代码如下:
from flask import Flask
app = Flask(__name__)
@app.route('/')
def index():
return 'Hello Flask'
if __name__ == '__main__':
# 配置IP为0.0.0.0,允许所有网络接口访问
app.run(host='0.0.0.0')
IP地址输入错误导致的404
启动应用后,如果访问时输入的IP地址和配置的host不一致,也会出现404错误。比如配置host为192.168.0.1,却用127.0.0.1访问,就无法正常打开页面。
端口配置相关问题与解决方法
端口被占用导致的异常
如果默认的5000端口被其他程序占用,Flask启动可能会失败,或者启动后访问对应端口出现404。这时候可以手动指定一个未被占用的端口。
指定端口的代码如下:
from flask import Flask
app = Flask(__name__)
@app.route('/')
def index():
return 'Hello Flask'
if __name__ == '__main__':
# 指定端口为8080,避免端口冲突
app.run(port=8080)
访问端口和配置端口不一致
如果启动应用的时候配置了端口为8080,访问的时候却用5000端口,同样会出现404错误,需要确保访问的端口和run方法里配置的port参数一致。
路由配置与404的关联
除了IP和端口的问题,路由配置错误也会引发404。比如定义了路由为/user,访问的时候却输入/users,即使IP和端口都正确,也会返回404。
路由配置的示例:
from flask import Flask
app = Flask(__name__)
# 正确定义的路由
@app.route('/user')
def user_page():
return 'User Page'
if __name__ == '__main__':
app.run(host='0.0.0.0', port=8080)
常见问题排查步骤
- 第一步:检查启动时的host和port参数,确认配置是否符合预期
- 第二步:检查访问时输入的IP地址和端口,是否和启动配置一致
- 第三步:检查访问的路由路径,是否和代码中定义的路由完全匹配
- 第四步:检查端口是否被其他程序占用,可通过命令行工具查看端口占用情况
注意:如果是在生产环境部署Flask应用,不建议直接使用app.run()启动,应该使用Gunicorn或者uWSGI等WSGI服务器,相关IP和端口配置需要在服务器启动参数中设置。