logging.exception() 更适合捕获异常,因为它自动附加完整栈跟踪;而 logging.error() 默认不带栈,需显式传 exc_info=True 且确保在 except 块中有效。
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。
立即学习“Python免费学习笔记(深入)”;
正确做法:
- 先用
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。