日志按级别输出到不同文件的实现方法

小伙伴们有没有觉得学习文章很有意思？有意思就对了！今天就给大家带来《logging 按级别输出到不同文件的方法》，以下内容将会涉及到，若是在学习中对其中部分知识点有疑问，或许看了本文就能帮到你！

FileHandler 本身不支持按级别自动拆分文件，因所有 Handler 共享同一 Logger 实例，日志进入 handle() 后会被全部处理；需为每个 FileHandler 绑定自定义 Filter 并重写 filter() 返回布尔值，配合 setLevel 实现精准分流。

为什么 FileHandler 本身不支持按级别拆分文件

直接给 FileHandler 设置 level 只会过滤它输出的内容，但所有 Handler 共享同一个 Logger 实例，日志一旦进入 Logger 的 handle() 流程，就会被所有已添加的 Handler 处理——除非你显式控制每个 Handler 的过滤逻辑。默认没有“自动分流”机制。

用 Filter 实现精准级别隔离

核心是为每个 FileHandler 绑定一个自定义 Filter，只让匹配级别的日志通过。注意：必须重写 filter() 方法并返回 True 或 False，不能只靠 super().filter(record)。

常见错误：
• 忘记在 filter() 中返回布尔值（导致默认拒绝）
• 用 record.levelno == logging.INFO 硬比较，结果 WARNING 日志进不了 warning.log（因为 WARNING 的 levelno 是 30，不是 20）
• 把 Filter 加在 Logger 上而非具体 Handler 上，造成全局误拦

示例关键片段：

class LevelFilter:
    def __init__(self, level):
        self.level = level
    def filter(self, record):
        return record.levelno == self.level  # 注意：是 ==，不是 >=
info_handler = logging.FileHandler('info.log')
info_handler.setLevel(logging.INFO)
info_handler.addFilter(LevelFilter(logging.INFO))
warning_handler = logging.FileHandler('warning.log')
warning_handler.setLevel(logging.WARNING)
warning_handler.addFilter(LevelFilter(logging.WARNING))

如果想让 WARNING 及以上都进 warning.log，该用 >= 还是 addFilter + setLevel 组合？

推荐组合使用：handler.setLevel(logging.WARNING) 控制最低接收门槛，再用 Filter 做精确分流。因为：

• setLevel 是 Handler 自身的门禁，低于它的日志根本不会走到 filter() 阶段
• 仅靠 Filter 不设 setLevel，会导致低级别日志（如 DEBUG）反复被判断、徒增开销
• 若真要收集 WARNING 及以上，Filter 内部用 record.levelno >= self.level 是安全的，但需确保 handler 的 setLevel 与之对齐（比如也设成 WARNING）

Windows 下中文路径或特殊字符导致 FileHandler 创建失败怎么办

错误现象通常是 PermissionError 或 FileNotFoundError，即使路径看起来合法。根本原因常是编码或路径解析问题。

实操建议：

• 用 os.path.abspath() 展开相对路径，避免隐式当前目录干扰
• 确保父目录存在：os.makedirs(os.path.dirname(log_path), exist_ok=True)
• 避免路径中出现未转义的反斜杠，优先用原始字符串或正斜杠：r'logs\warning.log' 或 'logs/warning.log'
• 如果路径含中文，确认 Python 运行环境默认编码支持（一般 UTF-8 没问题，但某些旧 Windows 控制台可能用 GBK）

最稳妥方式是先测试路径可写：with open(test_path, 'w'): pass，再初始化 FileHandler。

实际部署时，最容易被忽略的是多个 Handler 共用同一日志器却没关掉 logger.propagate，导致日志重复输出到根 logger 的控制台或默认文件。记得在配置完所有 Handler 后加一句 logger.propagate = False。

到这里，我们也就讲完了《日志按级别输出到不同文件的实现方法》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！