logging.exception() 更可靠,因它自动捕获完整回溯(含文件、函数、行号),而 logging.error(str(e)) 仅输出异常消息、丢失上下文;须在 except 块中调用且不传 exc_info 参数。

为什么 logging.exception() 比 logging.error(str(e)) 更可靠
因为 logging.exception() 会自动捕获当前异常的完整回溯(traceback),包括文件名、函数名、行号和每层调用栈;而手动用 str(e) 或 repr(e) 只能拿到异常消息本身,完全丢失上下文。常见错误是写成 logger.error("failed: " + str(e)),结果日志里只有 KeyError: 'missing',根本看不出在哪一行、哪个函数出的问题。
必须在 except 块内调用,且不能带参数——它隐式使用 sys.exc_info():
try:
risky_operation()
except ValueError:
logger.exception("Value error occurred") # ✅ 自动附带 traceback
如何让每条日志都带精确到行号的源码位置
关键不是改代码逻辑,而是配置 Formatter 的 format 字符串。默认的 %(levelname)s - %(message)s 不含位置信息;要显示行号,必须显式加入 %(lineno)d,并确保 %(filename)s 或 %(funcName)s 同时存在(否则行号意义不大)。
常见配置组合:
立即学习“Python免费学习笔记(深入)”;
-
%(asctime)s %(levelname)-8s [%(filename)s:%(lineno)d] %(message)s→ 显示main.py:42 -
%(levelname)s %(funcName)s() at %(filename)s:%(lineno)d — %(message)s→ 更适合调试时快速跳转
注意:%(lineno)d 是日志语句所在行号,不是被调用函数的行号;如果封装了日志工具函数,需加 stacklevel=2 才能跳到调用处。
logger.exception() 不生效?检查这三点
现象:日志只输出消息,没有 traceback。大概率是以下某个环节断了:
- 不在
except块中调用 ——exception()依赖当前线程的异常上下文,离开except就失效 - 用了
exc_info=False(显式或通过配置覆盖)—— 检查是否在logger.error(..., exc_info=True)里误设为False - 日志级别被设为高于
ERROR(比如CRITICAL)——exception()内部调用的是error(),级别不够就直接丢弃
验证方法:在 except 中补一句 import traceback; traceback.print_exc(),如果它能打出回溯,说明问题一定出在 logging 配置上。
异步环境(如 asyncio)下 traceback 行号可能错位
当异常发生在协程中,且未在协程内被捕获,而是冒泡到事件循环,logging.exception() 在顶层 except 中调用时,%(lineno)d 指向的是 await 那行,而非实际抛出异常的行。这是因为 Python 的 async traceback 会把 await 点作为“入口”,掩盖底层细节。
缓解方式:
- 在每个关键协程内部加
try/except,就近记录 —— 行号更准 - 启用
asyncio.get_event_loop().set_debug(True),会让 traceback 包含更多帧(但仅限开发) - 避免用
loop.run_until_complete(main())这种裸调用,改用asyncio.run(main())(Python 3.7+),它对异常传播更友好
真正难定位的,往往是跨多个 await 的链式调用,这时候光靠行号不够,得结合 %(funcName)s 和日志消息里的上下文变量来推断。



















