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。
