Flask errorhandler无法捕获视图函数无效响应错误如何解决？

问题原因 #

当视图函数返回非Flask支持的响应类型（如int）时，Flask内部会抛出TypeError：若处于Debug模式，Flask会直接返回HTML调试页面，自定义全局异常处理器不会生效；若使用Flask-RESTX等API扩展，全局app.errorhandler可能无法捕获扩展路由抛出的异常。

解决方案 #

1. 关闭Debug模式 #

Debug模式下Flask会绕过自定义错误处理器显示调试页面，将debug=False传入app.run()即可启用自定义错误处理：

if __name__ == "__main__":
    app.run(debug=False)

2. 为API扩展注册专属错误处理器 #

如果使用Flask-RESTX的Api对象定义路由（如@api.get），需给该api对象注册错误处理器，而非全局app：

from werkzeug.exceptions import HTTPException

@api.errorhandler(Exception)
def handle_api_exception(e):
    if not isinstance(e, HTTPException):
        print(e)
        return {
            "code": 500,
            "name": "Internal Server Error",
            "description": repr(e),
        }, 500
    else:
        return {
            "code": e.code,
            "name": e.name,
            "description": e.description,
        }, e.code

3. 覆盖默认500错误处理器 #

直接注册500状态码的错误处理器，确保所有服务器内部错误都返回JSON：

@app.errorhandler(500)
def handle_internal_error(e):
    return {
        "code": 500,
        "name": "Internal Server Error",
        "description": repr(e),
    }, 500

配合原有的全局Exception处理器，可覆盖绝大多数异常场景。

4. 提前校验并处理视图返回值 #

使用装饰器统一校验返回值类型，避免Flask抛出无效响应异常：

from functools import wraps
from flask import Response, json

def enforce_json_response(f):
    @wraps(f)
    def wrapper(*args, **kwargs):
        result = f(*args, **kwargs)
        
        # 处理合法响应类型
        if isinstance(result, (dict, list, str)):
            return result
        elif isinstance(result, tuple) and len(result) in (2, 3):
            data, status = result[:2]
            headers = result[2] if len(result) == 3 else {}
            if isinstance(data, (dict, list, str)):
                return data, status, headers
        
        # 尝试序列化非法类型，失败则返回错误
        try:
            json_data = json.dumps(result)
            return Response(json_data, content_type="application/json")
        except TypeError:
            return {
                "code": 500,
                "name": "Internal Server Error",
                "description": f"Unsupported response type: {type(result).__name__}"
            }, 500
    return wrapper

# 给视图函数添加装饰器
@api.get("/")
@enforce_json_response
def all(user):
    return 1

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