Flask 请求出现 404 Not Found 但路由已定义为什么访问不到

Flask 请求返回 404 但路由已定义通常是因为 URL 规则不匹配、蓝图前缀未对齐或应用实例未正确加载。优先检查路由装饰器参数和服务器转发配置，避免直接修改代码前未确认请求路径。

先说结论：大多数 404 问题源于请求路径与路由规则字符串不完全一致，或 WSGI 服务器剥离了部分路径前缀。

先确认：路由装饰器中的 URL 规则是否包含 trailing slash 及允许的 HTTP 方法。
先处理：检查 Blueprint 注册时的 url_prefix 是否与实际请求路径匹配。
再验证：使用 flask routes 命令列出所有可用路由进行比对。

快速处理思路

在不修改代码的前提下，优先通过命令行工具确认当前应用加载的路由列表。

export FLASK_APP=your_app.py
flask routes

如果命令不可用，检查启动命令是否指向了正确的 app 实例对象，确保没有导入错误的文件。

为什么会这样

Flask 的路由匹配机制对路径字符串和 HTTP 方法敏感，任何字符差异都会导致匹配失败。

Flask 使用 Werkzeug 路由系统，默认严格区分末尾斜杠。例如定义 `/user/` 时，访问 `/user` 会触发 308 重定向或直接 404，取决于配置。此外，蓝图（Blueprint）注册时若设置了 `url_prefix`，所有子路由都会自动添加该前缀，请求时若遗漏前缀则无法匹配。生产环境中，Nginx 或 Gunicorn 若配置了 `SCRIPT_NAME` 或路径重写，也会改变 Flask 接收到的路径信息。

分步处理

按照从应用内部到外部服务器的顺序逐步排查配置差异。

步骤 1：检查路由定义

确认代码中 `@app.route` 或 `@blueprint.route` 的字符串与浏览器地址栏完全一致，注意大小写和斜杠。

@app.route('/api/data', methods=['GET'])
def get_data():
    return 'OK'

若需要兼容有无斜杠，可定义两条路由或配置 `strict_slashes=False`。

步骤 2：检查蓝图前缀

查看蓝图注册代码，确认 `url_prefix` 参数。

app.register_blueprint(api_bp, url_prefix='/api')

此时实际访问路径应为 `/api/data` 而非 `/data`。

步骤 3：检查 WSGI 服务器配置

若使用 Nginx 反向代理，检查 `location` 块是否错误截断了路径。

location / {
    proxy_pass http://127.0.0.1:5000;
    proxy_set_header Host $host;
}

避免在 `proxy_pass` 后额外添加路径，除非明确需要重写。

怎么验证是否生效

通过 curl 命令或浏览器开发者工具确认状态码变为 200。

在终端执行 curl 请求，观察返回状态码。

curl -v http://localhost:5000/api/data

检查响应头中是否包含 `200 OK`。若仍为 404，查看 Flask 启动日志，确认请求是否到达应用层。若日志无记录，说明请求被 Nginx 或防火墙拦截。

常见坑

开发环境与生产环境的路径前缀处理逻辑不一致是高频错误源。

末尾斜杠：定义 `/abc/` 却访问 `/abc`，默认行为可能不同。
HTTP 方法：路由只允许 POST，却使用 GET 请求，Flask 可能返回 405 或 404。
应用工厂模式：若使用 `create_app` 工厂函数，确保启动命令加载了包含路由注册逻辑的实例。
循环导入：路由文件导入 app 实例时发生循环引用，导致路由未成功注册。

常见问题

为什么本地开发正常，部署到 Nginx 后出现 404？

通常是 Nginx 配置中的 `proxy_pass` 或 `location` 路径匹配规则导致路径被错误修改。

检查 Nginx 配置是否去除了 URL 前缀，确保 `proxy_pass` 后方没有多余斜杠，并检查 `SCRIPT_NAME` 环境变量设置。

Flask 打印了请求日志但依然返回 404 是怎么回事？

说明请求已到达应用，但内部路由匹配失败，可能是 HTTP 方法不匹配或蓝图前缀错误。

检查路由装饰器中的 `methods` 参数，确认包含当前请求使用的动词，如 GET 或 POST。

使用 app.register_blueprint 后路由访问不到怎么办？

可能是蓝图注册顺序问题或未指定正确的 url_prefix。

确保在 `app.run` 或 WSGI 服务器启动前完成蓝图注册，并核对注册时传入的前缀字符串。

参考来源

Flask 官方文档 - Quickstart: https://flask.palletsprojects.com/
Flask 官方文档 - Blueprints: https://flask.palletsprojects.com/en/latest/blueprints/
Werkzeug 路由规则文档: https://werkzeug.palletsprojects.com/