Python日志与异常处理技巧

本文深入解析了Python日志系统中异常追踪的核心技巧，重点对比了`logging.exception()`与`logging.error(exc_info=True)`的本质区别——前者自动捕获并格式化当前异常栈，后者需显式传参且依赖异常上下文；同时揭示了常见误用陷阱（如在except块外调用、错误传入`str(e)`、滥用`%(exc_text)s`导致性能下降），并提供了结构化日志中安全保留完整traceback的实操方案，帮助开发者精准、高效、可靠地记录异常现场，真正让日志成为排障利器。

logging.exception() 为什么比 logging.error() 更适合捕获异常

因为 logging.exception() 会自动附加当前异常的完整栈跟踪（traceback），而 logging.error() 默认只记录消息，不带栈——哪怕你在 except 块里调用它，也不会自动抓取 sys.exc_info()。

实操建议：

• 必须在 except 块内部调用 logging.exception()，否则它拿不到活跃异常上下文，输出的 traceback 为空或错位
• 不要写 logging.exception(str(e)) —— 这会把异常信息转成字符串再传入，反而掩盖原始类型，导致日志中丢失 exc_info 结构
• 如果想自定义前缀消息，直接传字符串： logging.exception("处理用户请求时失败")，它会在该消息后追加 traceback

手动传入 exc_info=True 的适用场景

当你不在 except 块中，但又需要记录某个已捕获异常的栈（比如异常被重新抛出、或在装饰器/中间件里统一处理），就得显式传参。

常见错误现象：只写 logging.error("msg", exc_info=True) 却没处在异常上下文中 → 日志里出现 NoneType: None 或空 traceback。

正确做法：

• 先用 sys.exc_info() 捕获当前异常三元组：exc_type, exc_value, exc_traceback = sys.exc_info()
• 再调用 logging.error("msg", exc_info=(exc_type, exc_value, exc_traceback))
• 或者更简洁：在 except 中保存异常，之后任意位置调用 logging.error(..., exc_info=True) —— 只要还没退出该 except 块，exc_info=True 就有效

Formatter 中 %(exc_text)s 的作用与陷阱

%(exc_text)s 是 Formatter 支持的占位符，用于内联渲染异常栈文本。但它**不会主动触发栈收集**，只负责格式化已存在的 exc_info。

性能影响：开启它会让每条含异常的日志多一次 traceback 格式化开销，纯 info/warn 级别日志若误配该格式器，可能拖慢吞吐。

配置建议：

• 为不同 handler 设置不同 formatter：error handler 用含 %(exc_text)s 的，console handler 用精简版
• 避免在 root logger 的 formatter 里无差别加 %(exc_text)s —— 大量非异常日志会被强制尝试提取空 exc_info，徒增开销
• 若需控制栈深度（比如只显示最后 3 层），得自定义 formatter，重写 formatException() 方法

结构化日志（如 JSON）中如何保留栈信息

用 json.dumps() 直接序列化日志 record 会丢掉 exc_info，因为它是 tuple + traceback 对象，不可 JSON 序列化。

关键点：必须在 formatter 层就将 exc_info 转成字符串，再塞进 dict。

实操方式：

• 继承 logging.Formatter，在 format() 中检测 record.exc_info，调用 self.formatException(record.exc_info) 得到字符串
• 把结果赋给 record.exc_text（自定义字段），再在 JSON 模板里引用 %(exc_text)s
• 别依赖第三方库（如 python-json-logger）的默认行为——有些版本对 exc_info 处理不一致，上线前务必用真实异常测试输出

最易被忽略的是：即使用了结构化日志，exc_info=True 仍必须显式传入 log 调用，否则 record.exc_info 为 None，后续所有处理都失效。

本篇关于《Python日志与异常处理技巧》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！