本文介绍在 flask 中正确实现“捕获除 `/static` 外所有请求路径”的方案，避免覆盖内置静态文件服务，并推荐使用 404 错误处理器替代通配路由，确保静态资源正常加载。
Flask 默认会自动处理 /static/ 路径下的静态文件（如 CSS、JS、图片），前提是已正确配置 static_folder（默认为项目根目录下的 static 文件夹）。但若使用通配路由（如 @app.route('/<path:path>')），该路由会优先匹配所有路径，包括 /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/* 的原生支持，又实现了灵活的“兜底路由”，是生产环境中推荐的标准实践。
