Python日志级别设置与使用方法

本文深入解析了Python日志系统的层级机制与实战要点，指出DEBUG日志在生产环境默认不可见的根本原因在于根logger的WARNING级别设计，并强调logger和handler需**同时设置level**才能生效；厘清INFO与WARNING的本质区别——前者描述预期中的正常流程节点，后者标识虽未中断服务但需人工关注的异常情况；提醒避免滥用自定义级别，推荐用DEBUG配合结构化字段实现细粒度追踪；特别警示ERROR日志缺失traceback的常见陷阱，强调必须显式传入`exc_info=True`或使用`logger.exception()`；最终落脚于日志设计的核心理念：每一条日志都应以“谁看、看什么、如何快速定位问题”为出发点，让日志真正成为线上排障的利器而非噪音源。

为什么 DEBUG 日志在生产环境默认看不到

因为 Python 的 logging 模块默认根 logger 级别是 WARNING，所有低于该级别的日志（DEBUG、INFO）会被直接丢弃，不经过 handler。这不是配置错误，而是设计使然——避免开发期日志污染生产输出。

常见误操作是只改了 handler 的 level（比如给 StreamHandler 设置 setLevel(logging.DEBUG)），却忘了同时调高 logger 本身的 level：

logger = logging.getLogger(__name__)
logger.setLevel(logging.DEBUG)  # ← 这行必须有
handler = logging.StreamHandler()
handler.setLevel(logging.DEBUG)
logger.addHandler(handler)

• logger 和 handler 的 level 是“双重过滤”：日志先过 logger 级别，再过 handler 级别
• 若用 basicConfig()，它只设置根 logger 和默认 handler，但不会覆盖已存在的 logger 配置
• 第三方库（如 requests、urllib3）也用 logging，它们的 logger 默认继承根级别，所以开 DEBUG 后可能刷出大量底层请求细节

INFO 和 WARNING 的边界怎么划

关键不是“严重程度”，而是“是否需要人关注”。INFO 应描述可预期的正常流程节点（如服务启动、定时任务开始、API 成功返回），而 WARNING 表示发生了异常但未中断流程（如降级启用、缓存失效、字段缺失但有兜底）。

• 不要把参数校验失败打成 INFO，那是业务异常，至少 WARNING；如果影响下游，应 ERROR
• 数据库连接重试第 1 次失败 → WARNING；重试 3 次全失败 → ERROR
• 用户主动触发的导出任务完成 → INFO；后台定时同步失败 → WARNING（因为没人盯着看）

自定义日志级别真的有必要吗

绝大多数项目不需要。Python 支持用 logging.addLevelName() 注册新级别（如 TRACE），但会带来三个实际问题：

• 日志分析工具（ELK、Sentry）通常只识别标准五级，自定义级别可能被忽略或归为 UNKNOWN
• 团队协作成本上升：新人得查文档才知道 TRACE 比 DEBUG 更细，且含义是否和你一致
• filter、Formatter、Handler 的逻辑都要额外适配，容易漏掉某处判断

更轻量的做法是用 DEBUG + 结构化字段区分粒度：logger.debug("cache hit", extra={"subsystem": "redis", "trace_id": tid})，再通过日志平台的字段过滤替代级别膨胀。

为什么 ERROR 日志里经常缺 traceback

因为直接写 logger.error("failed to process") 不会自动捕获异常上下文。必须显式传入 exc_info=True 或使用 logger.exception()（它是 error(..., exc_info=True) 的语法糖）。

try:
    risky_call()
except ValueError as e:
    logger.error("value error occurred", exc_info=True)  # ← 正确
    # 或等价写法：
    # logger.exception("value error occurred")

• logger.error("msg", exc_info=e) 也可以，但 e 必须是 Exception 实例，不能是字符串
• 在 except 块外想记录最近一次异常？用 sys.exc_info()，但注意它只在异常处理上下文中可靠
• 异步场景（如 asyncio）中，未被 await 的协程抛出的异常可能丢失 traceback，需配合 loop.set_exception_handler

日志级别本身不难配，难的是让每条日志在出问题时真能帮上忙——这意味着要时刻想着“谁会看这条日志？他需要什么信息才能快速定位？”而不是仅仅填满 level 字段。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Python日志级别设置与使用方法》文章吧，也可关注golang学习网公众号了解相关技术文章。