Python logging 如何让 WARNING 以上输出到 stderr,INFO 输出到 stdout

Python logging默认不区分stdout/stderr是因为仅用一个绑定sys.stderr的StreamHandler;需配置两个独立Handler:INFO级绑定sys.stdout并加过滤器,WARNING+级绑定sys.stderr并加过滤器,且初始化前应清空root logger默认Handler。

为什么默认的 logging 不区分 stdout/stderr?

Python 的 logging 默认只用一个 Handler(通常是 StreamHandler),它绑定到 sys.stderr,所以所有日志都走 stderr。想让 INFO 走 stdout、WARNING+ 走 stderr,得手动拆开——不能靠级别过滤器(Filter)来“重定向”,而要配两个独立的 Handler,各自绑定不同流。

怎么配置两个 Handler 分别绑定 stdout 和 stderr?

核心是创建两个 StreamHandler:一个传 sys.stdout,一个传 sys.stderr;再给它们分别设置 level,并加 Filter 避免重复输出(否则 WARNING 会同时出现在 stdout 和 stderr):

import logging
import sys

logger = logging.getLogger() logger.setLevel(logging.DEBUG) # 确保接收所有级别

INFO handler → stdout

info_handler = logging.StreamHandler(sys.stdout) info_handler.setLevel(logging.INFO) info_handler.addFilter(lambda record: record.levelno == logging.INFO) formatter = logging.Formatter('%(levelname)s - %(message)s') info_handler.setFormatter(formatter)

WARNING+ handler → stderr

warn_handler = logging.StreamHandler(sys.stderr) warn_handler.setLevel(logging.WARNING) warn_handler.addFilter(lambda record: record.levelno >= logging.WARNING) warn_handler.setFormatter(formatter)

logger.addHandler(info_handler) logger.addHandler(warn_handler)

注意:addFilter 是必须的。否则 warn_handler 会收到 INFO 日志(因为它的 level 是 WARNING,但父 logger 已经把 INFO 发给了它),导致 INFO 也刷到 stderr。

INFO 和 WARNING+ 之间有空档(比如 WARNING 和 ERROR)要怎么处理?

上面示例中,record.levelno >= logging.WARNING 覆盖了 WARNINGERRORCRITICAL,没问题。但如果你还用了自定义级别(比如 logging.addLevelName(35, 'NOTICE')),就得确保它的数值落在对应区间里。常见级别数值:

  • INFO 是 20
  • WARNING 是 30
  • ERROR 是 40
  • CRITICAL 是 50

只要自定义级别数值 ≥30,就归 stderr;=20 才归 stdout。别设成 25 这种中间值,否则两边都收不到。

有没有更干净的写法?比如用 dictConfig?

有,但要注意 dictConfig 本身不支持在 handlers 里直接写 sys.stdout(因为序列化限制),得用 'class': 'logging.StreamHandler' + 'stream': 'ext://sys.stdout' 这种字符串引用:

import logging.config

LOGGING_CONFIG = { 'version': 1, 'disable_existing_loggers': False, 'handlers': { 'stdout': { 'class': 'logging.StreamHandler', 'level': 'INFO', 'stream': 'ext://sys.stdout', 'filters': ['is_info'], }, 'stderr': { 'class': 'logging.StreamHandler', 'level': 'WARNING', 'stream': 'ext://sys.stderr', 'filters': ['not_info'], }, }, 'filters': { 'is_info': {'()': lambda: lambda r: r.levelno == 20}, 'not_info': {'()': lambda: lambda r: r.levelno >= 30}, }, 'root': { 'level': 'DEBUG', 'handlers': ['stdout', 'stderr'], } } logging.config.dictConfig(LOGGING_CONFIG)

这种写法可复用性强,适合配置驱动场景;但调试时不如纯 Python 代码直观——比如 'ext://sys.stdout' 写错会静默失败,建议先跑通基础版再迁移到 dictConfig。

最易被忽略的一点:别忘了关闭 root logger 的默认 handler(logging.basicC

onfig() 或首次调用 logging.warning() 会自动加一个),否则你的双流逻辑会被干扰。初始化前加一句 logging.getLogger().handlers.clear() 更稳妥。