logging.exception() 更可靠,因它自动捕获异常上下文并强制ERROR级别记录,等价于logger.error("msg", exc_info=True),简洁且不依赖前序日志状态。

为什么 logging.exception() 比 logging.error() + traceback.print_exc() 更可靠
因为 logging.exception() 会自动捕获当前异常上下文(包括 traceback),并强制使用 ERROR 级别记录,而手动调用 traceback.print_exc() 只输出到 stderr,不进日志系统,容易漏掉或与日志不同步。
- 必须在
except块内调用,否则拿不到活跃异常(sys.exc_info()为空) - 它等价于
logger.error("msg", exc_info=True),但更简洁、不易误写 - 若已用
exc_info=False记录过一次,再调logging.exception()仍能正确输出 traceback —— 它不依赖前序日志状态
如何让每条日志都带上 request_id 或 trace_id(尤其在 Flask/FastAPI 中)
靠全局 logger 不行,得用 LoggerAdapter 动态注入上下文字段。硬编码 extra 参数或拼接字符串会导致日志结构混乱、无法被 ELK 正确解析。
- 定义适配器:
class RequestContextAdapter(logging.LoggerAdapter): def process(self, msg, kwargs): extra = kwargs.pop("extra", {}) extra.update({"request_id": getattr(self, "request_id", "N/A")}) kwargs["extra"] = extra return msg, kwargs - 在请求入口(如 Flask 的
@app.before_request)中绑定:logger = RequestContextAdapter(logging.getLogger("myapp"), {"request_id": request.headers.get("X-Request-ID", str(uuid.uuid4()))}) - 后续所有
logger.info()、logger.error()调用都会自动带request_id字段,无需重复传extra=...
捕获未处理异常时,logging.critical() 为什么比 print() 更值得信赖
Python 进程崩溃前的 sys.excepthook 或 threading.excepthook 中,print() 可能因 stdout 缓冲、重定向失效或线程退出而丢失输出;logging.critical() 则走完整 handler 链,支持文件轮转、网络上报、结构化格式。
- 重设主线程异常钩子:
def handle_uncaught_exception(exc_type, exc_value, exc_traceback): logging.critical("Uncaught exception", exc_info=(exc_type, exc_value, exc_traceback)) sys.excepthook = handle_uncaught_exception - 对子线程同样生效:
threading.excepthook = lambda args: logging.critical( f"Uncaught in thread {args.thread.name}", exc_info=(args.exc_type, args.exc_value, args.exc_traceback) ) - 注意:不要在钩子里调
logger.exception()—— 它隐式读取sys.exc_info(),而钩子参数已封装好,直接用exc_info=...更稳妥
JSON 日志格式下,exception 字段为何常为空?怎么修复
多数 JSON 日志处理器(如 python-json-logger)默认不序列化 exc_info,只保留 exc_text 字符串字段;若没显式启用 traceback 解析,exception 对象就为空对象或缺失。
立即学习“Python免费学习笔记(深入)”;
- 使用
JsonFormatter时,必须传fmt="%(asctime)s %(name)s %(levelname)s %(message)s %(exc_info)s"并确保exc_info=True被传递 - 更推荐用
python-json-logger的扩展写法:from pythonjsonlogger import jsonlogger class CustomJsonFormatter(jsonlogger.JsonFormatter): def add_fields(self, log_record, record, message_dict): super().add_fields(log_record, record, message_dict) if record.exc_info: log_record["exception"] = self.formatException(record.exc_info) - 关键点:
record.exc_info是元组,必须用self.formatException()转成字符串,否则 JSON 序列化会失败










