可通过 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)










