logging.exception() 必须在 except 块中调用以获取异常上下文并输出完整 traceback，离开该块则静默丢弃堆栈；logging.error() 需显式传 exc_info=True 才记录 traceback，否则仅输出消息。

因为 logging.exception() 自动绑定当前异常上下文并强制输出完整 traceback，而 logging.error() 默认不带堆栈——漏掉 exc_info=True 参数，日志就只剩一句“出错了”，线上根本没法定位问题。

logging.exception() 必须在 except 块里调用

它依赖 sys.exc_info() 获取当前异常三元组（type, value, traceback）。一旦离开 except 块，这个上下文就被清空，logging.exception() 会静默丢弃 traceback，只打一条空 error 日志。

• ✅ 正确：在 except ValueError as e: 内直接调用 logging.exception("解析失败")
• ❌ 错误：把异常对象 e 传给另一个函数，再在函数里调用 logging.exception() —— 此时已不在异常上下文中
• ⚠️ 注意：logging.exception() 本身不接受 exc_info 参数；传了会报 TypeError

logging.error() 漏掉 exc_info=True 就等于没记录异常

logging.error("请求超时") 和 logging.error("请求超时", exc_info=True) 看似只差一个参数，但效果天壤之别：前者只输出时间、级别、消息；后者才附上完整的 traceback，包括文件名、行号、调用链。

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限

下载

• 常见错误：写成 logger.error("failed", e) —— 这是在做字符串格式化，e 被当成了 %s 占位符的值，不是异常上下文
• 更糟的是：logger.error("failed", exc_info=e) 也不对，exc_info 应为 True 或三元组，不能直接传异常实例
• 如果需要动态控制是否打堆栈（比如某些环境只记录摘要），用 logging.error("msg", exc_info=should_log_traceback)

formatter 里 %(exc_text)s 不是万能的

很多人配了 %(exc_text)s 就以为万事大吉，结果日志里永远看不到堆栈——因为这个字段只在日志 level ≥ ERROR 且 exc_info 非空时才生效。

• 必须确保 handler 的 level ≤ ERROR，否则 logging.exception() 发出的日志被过滤掉
• %(asctime)s 默认不带毫秒，高并发下多条日志时间戳一样，建议改用 %(asctime)s.%(msecs)03d
• %(exc_text)s 输出的 traceback 不自动缩进，若需对齐，得自定义 Formatter 子类处理

真正容易被忽略的是：即使你用了 logging.exception()，如果 root logger 没配任何 handler（比如忘了调用 basicConfig() 或手动 addHandler），日志会彻底消失，连 warning 都不报。线上服务启动时务必检查 logger.handlers 是否非空。

Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！