本文旨在解决flask应用中常见的404错误，重点分析由不正确的ip地址/端口配置和防火墙阻碍导致的访问问题。教程将详细介绍如何通过调整`app.run`参数来确保应用可访问，并提示检查系统级防火墙设置，同时提供flask项目结构优化的建议，以帮助开发者构建健壮的web服务。
在开发和部署Flask应用时，遇到“The requested URL was not found on the server”的404错误是常见的问题。这种错误通常表示Web服务器无法找到客户端请求的资源，尽管代码中可能已经定义了相应的路由。本文将深入探讨导致Flask应用出现404错误的常见原因，并提供详细的排查与解决方案。
当Flask应用返回404错误时，通常有以下几个核心原因：
默认情况下，flask run或app.run()在调试模式下通常会监听127.0.0.1:5000（即localhost:5000）。这意味着只有在运行应用的同一台机器上才能通过localhost访问。如果需要从局域网内的其他设备访问，或者在部署到服务器时，必须配置应用监听所有可用的网络接口。
推荐的app.run配置：
为了让Flask应用能够被外部网络访问，应将host参数设置为"0.0.0.0"。这告诉Flask服务器监听所有可用的公共IP地址。同时，可以指定一个你希望使用的端口。
# 在你的WSGI入口文件 (例如 run.py 或 wsgi.py) 中
from blog import app as application # 假设你的Flask应用实例在blog/__init__.py中被命名为app
if __name__ == '__main__':
# 确保在开发环境中使用，生产环境应使用Gunicorn/uWSGI等WSGI服务器
application.run(host="0.0.0.0", port=5000, debug=True)验证访问：
配置完成后，尝试使用http://localhost:5000（在本地）或http://你的服务器IP地址:5000（从其他设备）来访问你的应用。
如果IP地址和端口配置正确，但仍然无法访问应用，那么防火墙很可能是罪魁祸首。防火墙可能会阻止入站连接到达你指定的端口。
排查步骤：
注意事项：
从提供的问题代码来看，存在一些潜在的项目结构和代码组织问题，这可能间接导致路由未正确加载，进而引发404错误。
问题分析：
在route.py中出现了两次app = Flask(__name__)的定义，并且在文件开头又通过from blog import app, db导入了app。这种做法是错误的，会导致app对象被重复创建或覆盖，使得路由没有被正确注册到最终运行的app实例上。
一个标准的Flask大型应用通常会采用应用工厂模式或模块化结构，将Flask应用实例的创建集中在__init__.py文件中，并将其导入到其他模块中使用。
推荐的项目结构示例：
blog/
├── __init__.py
├── models.py
├── routes.py
├── templates/
│ └── home.html
│ └── about.html
└── static/
└── ...
run.py # 或 wsgi.pyblog/__init__.py (应用工厂模式示例):
from flask import Flask
from flask_sqlalchemy import SQLAlchemy
import os
db = SQLAlchemy()
def create_app():
app = Flask(__name__)
app.config['SECRET_KEY'] = 'be35984218226b31d6ca0bf1ccefdaf78e47c9181177a41a'
basedir = os.path.abspath(os.path.dirname(__file__))
app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///' + os.path.join(basedir, 'blog.db')
db.init_app(app) # 初始化SQLAlchemy
# 注册蓝图或直接导入路由
from blog import routes # 导入routes模块，确保路由被注册
app.register_blueprint(routes.bp) # 如果routes.py中定义了蓝图
# 或者直接在__init__.py中导入所有路由函数
# from blog.routes import home, about
# app.add_url_rule('/', 'home', home)
# app.add_url_rule('/home', 'home', home)
# app.add_url_rule('/about', 'about', about)
with app.app_context():
db.create_all() # 在应用上下文中创建数据库表
return appblog/routes.py (使用蓝图):
from flask import Blueprint, render_template
from blog.models import Post # 从blog模块导入模型
bp = Blueprint('main', __name__) # 创建一个蓝图
@bp.route('/')
@bp.route("/home")
def home():
posts = Post.query.all()
return render_template('home.html', posts=posts)
@bp.route("/about")
def about():
return render_template('about.html', title='About')run.py (WSGI入口文件):
from blog import create_app # 从blog/__init__.py导入应用工厂函数
application = create_app() # 创建Flask应用实例
if __name__ == '__main__':
application.run(host="0.0.0.0", port=5000, debug=True)通过这种方式，app实例只在create_app()中创建一次，并且所有路由都通过导入routes模块或注册蓝图的方式正确地与该实例关联。这能有效避免因应用实例混乱导致的路由注册失败问题。
解决Flask应用中的404错误需要系统性的排查。首先，确保你的应用监听了正确的IP地址和端口，特别是当需要从外部访问时，将host设置为"0.0.0.0"是关键。其次，检查并配置好操作系统级和云服务提供商的安全组/防火墙规则，允许流量通过应用监听的端口。最后，对Flask项目的代码结构进行审查，确保应用实例被正确创建和管理，并且所有路由都被有效地注册。遵循这些步骤，将有助于你快速定位并解决Flask应用中的404错误，构建稳定可靠的Web服务。
以上就是Flask应用404错误排查：IP地址与防火墙配置深度解析的详细内容，更多请关注php中文网其它相关文章！
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移，垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是，许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
447
收藏
