Python Flask Web服务访问异常:127.0.0.1正常,IP/公网访问返回404
故障核心原因
- 代码执行顺序错位:Python采用自上而下的顺序执行逻辑,你编写的第一个服务启动块(
if __name__ == '__main__':)位置在所有路由定义的最前方,执行到该块时会直接进入Flask服务的阻塞运行状态,后续所有写在该块下方的路由装饰器代码完全没有执行机会,服务内部的路由表为空,所有路径请求自然都会返回404。你观察到127.0.0.1:5000可正常响应,是历史调试时代码顺序正确,末尾的启动块绑定5000端口提供服务的残留现象;在路由定义前新增80端口的启动块后,程序直接卡在前置启动逻辑上,5000端口服务未启动,所有打到80端口的请求因无匹配路由返回404。 - 重复设置了两处服务启动入口,第一处入口直接阻塞执行,代码末尾的第二处启动块永远不会被触发。
- 路由定义中的HTTP方法参数大小写不符合Flask规范,写作
Get、Post、Put,正确写法应为全大写的GET、POST、PUT,即使后续路由注册完成,也会因方法匹配失败触发错误响应。 - 导入了waitress生产WSGI服务但未实际调用,最终仍使用Flask自带的单线程开发服务器对外提供服务,不符合生产部署要求。
- 硬编码绑定了单块网卡的局域网IP
192.168.0.113,没有绑定所有网卡地址0.0.0.0,本身就会限制部分来源的请求接入。
修正步骤
- 调整代码顺序,将所有路由定义逻辑全部移至服务启动代码的前方,保证所有路由规则完成注册后,再触发服务启动流程。
- 合并重复的服务启动入口,将启动逻辑统一放在代码最末尾:
- 修正所有路由的HTTP方法写法,使用Flask要求的全大写格式
- 服务绑定地址改为
0.0.0.0,兼容回环地址、局域网、公网的所有接入请求,无需单独硬编码单个局域网IP - 生产环境实际调用waitress的
serve()方法启动服务,替换Flask自带的开发服务器;本地调试可保留app.run()配置,但同样需要修改绑定地址为0.0.0.0
修正后的可运行参考代码
from flask import Flask, jsonify app = Flask(__name__) courses = [ {'name': "Dirty Corporate Dairy", 'course_id': "0", 'Description': "Story about ", 'Price': "120"}, {'name': "Dirty Corporate Dairy 2", 'course_id': "1", 'Description': "Story about ", 'Price': "1200"}, {'name': "Dirty Corporate Dairy3", 'course_id': "2", 'Description': "Story about ", 'Price': "12000"} ] # 先完成所有路由注册 @app.route('/') def index(): return "Welcome To the Course API" @app.route("/courses", methods=['GET']) def get(): return jsonify({'Courses': courses}) @app.route("/courses/<int:course_id>", methods=['GET']) def get_course(course_id): return jsonify({'Courses': courses[course_id]}) @app.route("/courses", methods=['POST']) def create(): course = {'name': "Dirty Corporate Dairy7", 'course_id': "6", 'Description': "Story about", 'Price': "120000000"} courses.append(course) return jsonify({'Created': course}) @app.route("/courses/<int:course_id>", methods=['PUT']) def update(course_id): courses[course_id]["Description"] = "New Updated Description" return jsonify({'Courses': courses[course_id]}) # 最后执行服务启动 if __name__ == '__main__': # 生产环境使用waitress启动 from waitress import serve serve(app, host='0.0.0.0', port=80) # 本地调试可替换为下面的配置 # app.run(host='0.0.0.0', debug=True, port=80)
验证要点
- 启动服务后,分别通过回环地址、本机局域网IP、公网地址访问定义的路由,确认不再返回404,响应内容和预期一致
- 检查运行日志,确认服务绑定的是所有网卡地址,不存在网卡绑定不全的访问拦截
内容的提问来源于stack exchange,提问作者Shashank Deo
相关产品推荐
相关产品推荐

