本文介绍在 flask 中避免静态资源（如 `/static/`）被通配路由捕获的正确方法，推荐使用 404 错误处理器替代 `@app.route('/
在 Flask 中，开发者常希望通过通配路由（如 @app.route('/
❌ 错误做法（破坏静态服务）：
@app.route('/', defaults={'path': ''})
@app.route('/')
def catch_all(path):
return f'You want path: {path}' 此代码会劫持所有请求（包括 /static/style.css），使 Flask 不再调用其内置的 send_static_file 处理器。
✅ 正确做法：利用 404 Not Found 错误处理器
Flask 的静态文件路由具有最高优先级且自动注册；只有当无任何路由匹配且静态文件也不存在时，才会触发 404。因此，我们只需在 404 处理器中捕获“本应存在但未定义的业务路径”，即可安全实现“除 /static 外全匹配”：
from flask import Flask, request, send_from_directory
from werkzeug.exceptions import NotFound
app = Flask(__name__)
# ✅ 静态资源保持原生支持（无需额外配置）
# Flask 默认已启用：/static/ → app.static_folder
@app.errorhandler(NotFound)
def handle_404(e):
# 此时 request.path 已确认不匹配任何路由，且非真实静态文件
path = request.path
# 可在此添加 SPA 回退逻辑（如返回 index.html）
# 或返回自定义提示
return f'You want path: {path}', 404
# 示例：显式定义一个业务路由，验证优先级
@app.route('/api/ping')
def ping():
return {'status': 'ok'}? 关键说明：
- @app.errorhandler(NotFound) 仅在 路由未命中 + 静态文件不存在 时触发，完全兼容 /static/、/static/js/app.js 等路径；
- 若需 SPA 支持（如 React/Vue），可在 handle_404 中返回 send_from_directory(app.static_folder, 'index.html')；
- 切勿在 catch_all 路由中手动调用 send_from_directory 处理 /static —— 这会绕过 Flask 的缓存头、ETag、条件请求等优化机制；
- 如需排除其他路径（如 /healthz），可在 handle_404 中增加白名单判断，但通常无需——因为显式定义的路由天然优先。
总结：信任 Flask 的默认静态服务机制，用 404 处理器承接“兜底逻辑”，既简洁又健壮，是生产环境的最佳实践。
