logging 如何让不同模块输出不同级别的日志文件

可通过 logging.getLogger(__name__) 为各模块创建独立命名 logger,分别添加 FileHandler 并设置 level 和 propagate=False,避免 root logger 干扰,实现不同模块按需输出日志到不同文件。

可以通过 Python 的 logging 模块为不同模块配置独立的 logger,并分别设置日志级别和输出目标(如文件),实现“不同模块输出不同级别日志到不同文件”的效果。关键在于避免使用 root logger,而是为每个模块创建命名 logger,并单独配置 handler 和 level。

为每个模块创建独立命名 logger

在各模块中调用 logging.getLogger(__name__) 获取专属 logger。模块名(如 "database""api")会自动成为 logger 名称,便于区分和单独配置。

  • 模块 database.py 中写:
      logger = logging.getLogger("database")
  • 模块 api.py 中写:
      logger = logging.getLogger("api")
  • 不调用 logging.basicConfig(),否则会干扰自定义配置

为每个 logger 单独添加 FileHandler 并设级别

在主程序或配置模块中,为每个命名 logger 分别添加 handler,并设置其 level(注意:handler 有 level,logger 自身也有 level,两者都需满足才会输出)。

  • "database" logger 添加 DEBUG 级别文件 handler:

      db_logger = logging.getLogger("database")
      db_handler = logging.FileHandler("db_debug.log")
      db_handler.setLevel(logging.DEBUG)
      db_logger.addHandler(db_handler)
      db_logger.setLevel(logging.DEBUG)
  • "api" logger 添加 WARNING 级别文件 handler:
      api_logger = logging.getLogger("api")
      api_handler = logging.FileHandler("api_warning.log")
      api_handler.setLevel(logging.WARNING)
      api_logger.addHandler(api_handler)
      api_logger.setLevel(logging.WARNING)

避免日志重复和 root logger 干扰

默认情况下,logger 会向父 logger(最终是 root)传播日志。若不控制,日志可能同时写入多个文件或控制台。

  • 在每个自定义 logger 上设置 propagate = False
      db_logger.propagate = False
      api_logger.propagate = False
  • 确保 root logger 未被意外启用(例如没调用 basicConfig,或显式禁用:
      logging.getLogger().setLevel(logging.CRITICAL)
      logging.getLogger().handlers.clear()

可选:统一配置入口(推荐用 dictConfig)

将所有 logger、handler、level 配置写成字典,用 logging.config.dictConfig() 一次性加载,更清晰、易维护。

  • 示例片段:
      config = {
        "version": 1,
        "loggers": {
          "database": {"level": "DEBUG", "handlers": ["db_file"], "propagate": false},
          "api": {"level": "WARNING", "handlers": ["api_file"], "propagate": false}
        },
        "handlers": {
          "db_file": {"class": "logging.FileHandler", "filename": "db_debug.log", "level": "DEBUG"},
          "api_file": {"class": "logging.FileHandler", "filename": "api_warning.log", "level": "WARNING"}
        }
      }
  • 调用:
      logging.config.dictConfig(config)