flask 3.x 默认禁用未处理异常自动转500响应，需显式设 propagate_exceptions=false 并用 @app.errorhandler(exception) 或自定义异常类捕获，before_request 中 try/except 无效。
Flask 3.x 的 errorhandler 不再支持全局 500 错误捕获？
是的。Flask 3.x 默认禁用了未注册的未处理异常自动转为 500 响应的行为，这意味着抛出未捕获异常时，服务器会直接崩溃（开发模式下显示调试页，生产环境则可能返回空响应或连接中断），而不是触发你写的 @app.errorhandler(500)。
根本原因是 Flask 3.x 将 propagate_exceptions 默认设为 True，且移除了旧版中隐式兜底的异常传播链。必须显式启用全局异常拦截。
- 确保在创建
Flask实例后、注册路由前，设置app.config['PROPAGATE_EXCEPTIONS'] = False - 同时，
app.config['DEBUG']在生产环境必须为False，否则调试器会劫持异常，绕过你的errorhandler - 若使用
create_app()工厂模式，该配置必须在 app 实例化后立即设置，不能晚于app.register_blueprint()
如何用 @app.errorhandler(Exception) 捕获所有未处理异常？
这是最直接的全局兜底方式，但要注意：它只捕获未被更具体 handler 拦截的异常，且不会覆盖已注册的 404、400 等 HTTP 异常处理器。
典型写法：
@app.errorhandler(Exception)
def handle_unexpected_error(e):
app.logger.error(f"Unhandled exception: {e}", exc_info=True)
return {"error": "Internal server error"}, 500
- 务必在函数内调用
app.logger.error(..., exc_info=True)，否则 traceback 丢失，无法定位问题 - 返回值必须是合法的 Flask 响应：元组
(body, status)或jsonify({...})，不能只返回 dict - 不要在此处尝试“恢复”异常状态（比如重试数据库操作），它只是兜底日志+响应，业务逻辑应在视图内处理
自定义异常类 + @app.errorhandler 如何精准分流？
比捕获 Exception 更健壮的做法是定义业务异常（如 InvalidTokenError、ResourceNotFound），并在对应 handler 中返回语义化状态码和消息。
示例：
class InvalidTokenError(Exception):
pass
@app.errorhandler(InvalidTokenError)
def handle_invalid_token(e):
return {"error": "Invalid or expired token"}, 401
- 自定义异常继承
Exception即可，无需实现特殊方法 - handler 函数名任意，关键在于装饰器参数是异常类本身（不是字符串）
- 如果多个异常想共用一个 handler，可用元组：
@app.errorhandler((ValueError, TypeError)) - 注意：Flask 内置的
HTTPException子类（如NotFound）会优先匹配@app.errorhandler(404)，而非Exceptionhandler
为什么 before_request + try/except 不推荐作全局异常处理？
有人试图在 @app.before_request 里包一层 try/except，但这完全无效——before_request 只在请求预处理阶段运行，视图函数抛出的异常不会回溯到这里。
-
before_request的异常只能被捕获在它自己内部，不影响后续视图执行 - 真正要拦截视图异常，唯一可靠位置是
@app.errorhandler或 WSGI 中间件（如werkzeug.middleware.proxy_fix.ProxyFix不处理这个） - 若需在请求生命周期早期做校验并提前中断，应抛出
abort(400)或自定义异常，再由对应errorhandler处理
PROPAGATE_EXCEPTIONS）就会让自定义 handler 彻底失效，而且错误表现不明显——请求静默失败，日志里也没记录。调试时先确认 app.config 状态，再检查 handler 是否被 import 和注册，最后看 logger 是否启用了 exc_info=True。Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
