[python] pprika：基于werkzeug编写的web框架(3) ——错误处理
错误处理示例
from pprika import PPrika app = PPrika() @app.error_handler(404) def not_found(e): print(e) return repr(e) if __name__ == '__main__': app.run()
与flask一样，通过error_handler装饰器来注册错误处理函数。该装饰器接受一个HTTP错误码或异常类(Exception)作为参数，会将发生的具体错误对象传递给处理函数。
上述代码指当发生404错误时以not_found作为处理函数，其返回值跟视图函数一样会被处理成响应返回，而error_handler只是 register_error_handler 的装饰器版本，上方错误注册可改写成 app.register_error_handler(404, not_found) ，因此重点讲述register_error_handler。
register_error_handler
def register_error_handler(self, code_or_exception, func, field=None): if isinstance(code_or_exception, Exception): raise ValueError(f""" 不可注册异常实例: {repr(code_or_exception)}， 只能是异常类或HTTP错误码 """) exc_class, code = self._get_exc_class_and_code(code_or_exception)
field参数表示该错误处理规则的适用范围，为None时表示作用于全局(app)；为str时是蓝图名，表示仅作用于该蓝图(blueprint)内，非None的情况之后讲蓝图的时候会再提及。
注意到其中调用了 _get_exc_class_and_code，它会根据错误码或者异常类其中一个尝试补出对应的另一个，比如本例中code_or_exception=404，经过该函数处理会补出 werkzeug.exceptions.NotFound。
依据错误码得到异常类主要通过 werkzeug.exceptions 包中的一个字典default_exceptions，它以{http_error_code: exception_class}的形式记录了错误码与对应异常类的映射，反过来若异常类为HTTPException子类则e.code即为错误码，其他异常就统一将错误码当做None。具体实现方法与flask同名函数几乎一样，不再赘述。
handlers = self.error_handlers.setdefault(field, {}).setdefault(code, {})
handlers[exc_class] = func
紧接上文，error_handlers是一个字典：{field: {status: {error: function}}}，通过作用范围、错误码、具体错误类三层记录该错误类exc_class具体的处理函数func，这样一个错误处理函数就注册好了。
接下来会讲述错误发生时的处理方式。
handle_user_exception
这是上一篇提到的dispatch_request内部的错误处理函数，也是内层错误处理
dispatch_request内部片段↓↓↓
try: endpoint, args = request.rule.endpoint, request.view_args rv = self.view_functions[endpoint](**args) except Exception as e: rv = self.handle_user_exception(e)
当该过程(尤其指视图函数被调用时)产生的异常会被捕捉交给 handle_user_exception 处理。
def handle_user_exception(self, e): handler = self._find_error_handler(e) if handler is not None: return handler(e) raise e
该函数负责的是像本实例中通过error_handler装饰器或register_error_handler方法注册过的错误，若该错误未被注册将再次将其抛出。
其中 _find_error_handler 内部先通过python内置的type函数得到异常类exc_class
，再通过上述的 _get_exc_class_and_code方法获得错误码code。
由于一个错误可能在不同范围、以不同错误码注册过，因此查找时以错误码取code、None，在此基础上再以field取blueprint(表蓝图范围)、取None(表全局范围)的顺序在 self.error_handlers 中查找处理函数，若找不到则按None返回。具体实现方法同样与flask同名函数几乎一样，暂且略过，之后讲述restful部分时可能会有补充。
handle_exception
该函数作为外层错误处理器受 wsgi_app 调用，处理 handle_user_exception 无法处理的，或处理过程中再次发生的异常
wsgi_app内部片段(去掉了不相关的)↓↓↓
try: rv = self.dispatch_request() response = make_response(rv) except Exception as e: response = self.handle_exception(e)
与handle_user_exception配合形成两层的错误处理，确保错误能正确响应
下方是其实现原理
def handle_exception(self, e): if isinstance(e, HTTPException): return e
首先判断如果是HTTPException或其子类实例则直接返回
server_error = InternalServerError() server_error.original_exception = e handler = self._find_error_handler(e) or self._find_error_handler(server_error)
到了这一步说明该错误可能没有对应的错误处理器，也不是能直接作为response的HTTPException，那就统一当做 '500 InternalServerError' 响应，并在此尝试获取其handler(以原错误先尝试获取是考虑到可能是handle_user_exception处理中的再次发生的异常)
if handler is not None: server_error = handler(server_error) else: print_exception(*exc_info()) return make_response(server_error)
最后若能找到handler则将返回值生成make_response并返回，否则说明不能自行处理该错误，打印出Traceback并直接返回InternalServerError(make_response内部也会把HTTPException这类的直接返回)。
注意此处不能将无法处理的server_error再次raise并同时returnmake_response(server_error)，即便使用try...finally也不行，raise与return不共存。但又需要显示错误信息(traceback)，故通过exc_info得到traceback信息并由print_excption打印出来。
from sys import exc_info from traceback import print_exception
这点与flask不同，它利用self.propagate_exceptions决定是否再次抛出，self.log_exception、self.logger对该错误进行记录，更加细致，具体的没有深入了...
结语
至此错误处理部分结束，不过这部分之后在将restful时会有进一步的补充，接下来先讲讲请求上下文。
