如何通过Flask错误处理器一次性捕获所有Werkzeug异常？

我懂你的困扰！你现在的全局异常处理器能捕获通用Exception，但没法针对性处理Werkzeug的HTTP异常——其实Werkzeug所有的HTTP相关异常都继承自同一个父类HTTPException，我们可以直接针对这个类写错误处理器，就能一次性捕获所有Werkzeug异常了。

具体实现代码 #

首先导入Werkzeug的HTTPException类，然后编写对应的错误处理器：

from werkzeug.exceptions import HTTPException

@opendataApp.errorhandler(HTTPException)
def handle_werkzeug_errors(error):
    # 构建统一的JSON响应格式
    response_data = {
        'error': {
            'message': error.description or str(error),
            'status_code': error.code
        }
    }
    # 返回响应和对应的HTTP状态码
    return response_data, error.code

为什么这样有效？ #

Werkzeug的所有HTTP异常（比如NotFound、BadRequest、Unauthorized等）都是HTTPException的子类，Flask的错误处理器会优先匹配最具体的异常类型，所以这个处理器会拦截所有Werkzeug抛出的HTTP异常，而你的原有Exception处理器依然会处理非Werkzeug的异常（比如业务逻辑抛出的自定义异常），两者互不冲突。

额外技巧 #

如果你需要对某个特定Werkzeug异常做特殊处理，依然可以单独写针对性的处理器，它的优先级会高于全局的HTTPException处理器，比如：

@opendataApp.errorhandler(404)
def handle_not_found(error):
    return {'error': {'message': '资源未找到，请检查请求路径'}}, 404

这样404异常会走这个专属处理器，其他Werkzeug异常还是用全局的HTTPException处理器处理。

内容的提问来源于stack exchange，提问作者jlandercy