如何在 Flask 中实现匹配所有路径（除 /static 外）的通用路由

本文介绍在 flask 中正确实现“捕获除 `/Static` 外所有请求路径”的方案，避免覆盖内置静态文件服务，并推荐使用 404 错误处理器替代通配路由，确保静态资源正常加载。

Flask 默认会自动处理 /static/ 路径下的静态文件（如 css、js、图片），前提是已正确配置 static_folder（默认为项目根目录下的 static 文件夹）。但若使用通配路由（如 @app.route(‘/‘)），该路由会优先匹配所有路径，包括 /static/style.css，从而拦截原本应由 Flask 静态处理器响应的请求，导致静态资源无法加载。

因此，不建议用通配路由覆盖全部路径。更健壮、符合 Flask 设计哲学的做法是：保留默认静态路由，仅对未被任何显式路由或静态规则匹配的请求进行统一处理——这正是 404 错误处理器的职责。

以下为推荐实现方式：

from flask import Flask, request, send_from_directory from werkzeug.exceptions import NotFound  app = Flask(__name__)  # ✅ 保持默认静态文件服务（无需额外配置，除非自定义 static_folder） # Flask 自动注册 /static → static_folder 的映射  # ✅ 使用 404 处理器捕获所有“未命中”路径（即非静态、非其他路由的请求） @app.errorhandler(NotFound) def catch_all(e):     path = request.path     # 可在此添加日志、权限校验、SPA 前端路由兜底等逻辑     return f'You want path: {path}', 404  # 或返回渲染的模板：render_template('spa.html')

⚠️ 注意事项：

• 确保 catch_all 函数名不与已有视图函数冲突；
• 若项目使用前端框架（如 react/vue）并启用 html5 history 模式，此 404 处理器可作为 SPA 的路由兜底，返回 index.html；
• 如需排除其他路径（如 /healthz、/api），应在 catch_all 内部手动判断并提前返回，或通过更细粒度的路由注册实现；
• 不要删除或重写 Flask 的静态路由；可通过 app.url_map 查看当前所有路由规则以验证。

该方案既保证了 /static/* 的原生支持，又实现了灵活的“兜底路由”，是生产环境中推荐的标准实践。