Python logging如何禁用StreamHandler输出的第三方库警告

之前的配置不生效有两个核心原因：

• pandas抛出的SettingWithCopyWarning属于Python标准库warnings模块生成的警告，默认直接输出到stderr，不经过logging模块的分发链路，因此logging.disable(logging.WARNING)对这类内容完全无效。
• 你当前给根logger绑定的StreamHandler没有加过滤规则，所有第三方库子logger向上传播的WARNING级别日志，都会被这个处理器接收并打印到控制台。

根据你“保留第二个日志处理器的全量日志输出，仅让StreamHandler屏蔽第三方警告”的需求，按以下步骤配置即可：

1. 处理warnings模块抛出的原生警告 #

针对pandas这类不走logging的警告，有两种处理方式：

• 直接屏蔽指定类别的警告：在所有第三方库导入代码的最开头添加以下配置

import warnings
from pandas.errors import SettingWithCopyWarning
# 单独屏蔽pandas的SettingWithCopyWarning，其他类别的警告可按相同格式追加
warnings.filterwarnings("ignore", category=SettingWithCopyWarning)

• 如果需要把警告写入日志文件但不在控制台打印，不要直接屏蔽警告，而是将警告重定向到logging链路：

import logging
import warnings
# 把所有warnings输出重定向到名为py.warnings的logger
logging.captureWarnings(True)

2. 给StreamHandler添加过滤器，拦截第三方库的WARNING级别日志 #

不要直接修改全局日志级别，避免影响你另一个日志处理器（比如文件处理器）的全量日志记录，只给控制台输出的StreamHandler绑定自定义过滤器即可：

import logging
import sys

class ThirdPartyWarningFilter(logging.Filter):
    def __init__(self, project_root_logger: str):
        super().__init__()
        self.project_root = project_root_logger

    def filter(self, record) -> bool:
        # 放行当前项目自身输出的所有日志
        if record.name.startswith(self.project_root) or record.name == "root":
            return True
        # 第三方库输出的日志，仅放行INFO及以下级别，WARNING及以上级别拦截
        return record.levelno < logging.WARNING

# 你的原有日志配置
logger = logging.getLogger()
logger.setLevel(logging.INFO)
# 初始化控制台处理器
ch = logging.StreamHandler(sys.stdout)
ch.setLevel(logging.INFO)
# 绑定过滤器，括号内替换为你自己项目的根logger名称
ch.addFilter(ThirdPartyWarningFilter("your_project_logger_name"))
logger.addHandler(ch)

# 第二个日志处理器（比如文件处理器）不需要加过滤器，会正常接收所有级别日志
# fh = logging.FileHandler("runtime.log")
# fh.setLevel(logging.INFO)
# logger.addHandler(fh)

轻量替代方案 #

如果不需要精细控制过滤规则，也可以直接给需要屏蔽警告的第三方库logger单独设置更高的日志阈值，让其WARNING级别日志不会向上传播到根logger：

# 列表内替换为你需要屏蔽WARNING输出的第三方库名
for third_party_lib in ["pandas", "numpy", "requests"]:
    logging.getLogger(third_party_lib).setLevel(logging.ERROR)

• warnings模块的过滤配置必须放在导入对应第三方库的代码之前执行，否则配置会失效。
• 如果使用logging.captureWarnings(True)重定向警告，不需要额外配置py.warnings logger，它会默认把日志传播到根logger，由你绑定的过滤器自动完成控制台拦截、文件写入的分流。

内容的提问来源于stack exchange，提问作者NineWasps