本文介绍如何在 flask 中优雅地捕获除 `/static` 资源外的所有请求路径，避免覆盖内置静态文件服务，推荐使用 `@app.errorhandler(404)` 替代通配符路由实现安全、可靠的兜底逻辑。
在 Flask 中，开发者有时希望为“几乎所有页面”提供统一的后端处理逻辑（例如前端单页应用的客户端路由），但又必须确保 /static/ 下的 CSS、JS、图片等静态资源能被 Flask 默认的静态文件处理器正常响应。若直接使用通配符路由如 @app.route('/
✅ 正确做法：不注册通配符路由，而是利用 404 错误处理器
Flask 的静态文件服务（默认挂载在 /static）具有高优先级且自动生效；只有当请求路径未被任何显式路由匹配，且静态文件也不存在时，才会触发 404 Not Found。因此，我们只需在 404 处理器中判断：若请求路径以 /static/ 开头，则不应干预（让其自然返回 404，或可选择重定向/忽略）；否则，按需处理——这正是安全兜底的核心逻辑。
以下是推荐实现：
from flask import Flask, request, send_from_directory
from werkzeug.exceptions import NotFound
import os
app = Flask(__name__)
# ✅ 保留默认静态文件服务（无需额外配置，Flask 自动启用）
# 静态文件将从 ./static/ 目录提供，路径 /static/** 始终优先被正确处理
@app.errorhandler(NotFound)
def catch_all_404(e):
path = request.path
# 可选：显式排除 /static/ 开头的路径（增强健壮性）
if path.startswith('/static/'):
# 若仍想支持 /static/ 下的自定义逻辑，可在此处理；
# 否则直接抛出原异常，保持默认 404 行为
raise e
# ✅ 此处处理所有其他未匹配路径（即真正的“前端路由”入口）
return f'Frontend route requested: {path}'
# （可选）如需自定义静态目录行为，可显式定义（但通常无需）
# @app.route('/static/')
# def custom_static(filename):
# return send_from_directory(app.static_folder, filename) ⚠️ 注意事项：
-
不要使用 @app.route('/
') 或类似通配符路由来替代 404 处理器——它会无差别拦截所有路径，破坏静态资源服务。 - Flask 默认已启用静态文件服务（app.static_folder = 'static', app.static_url_path = '/static'），只要不覆盖 /static/ 相关路由，即可零配置保障静态资源可用。
- @app.errorhandler(404) 是语义清晰、职责分明的方案：它只在真正“未找到”时触发，天然绕过静态路径冲突。
- 若项目使用 flask run 开发服务器，确保 static/ 目录存在且权限正常；生产环境部署时（如 Nginx + Gunicorn），建议将 /static/ 路径交由 Web 服务器直接托管，进一步提升性能与可靠性。
总结：用 404 错误处理器实现“除 /static 外全路径捕获”，既符合 Flask 设计哲学，又规避了路由优先级陷阱，是构建前后端分离应用（如 React/Vue + Flask API）时最稳健的路由兜底策略。
