如何通过dictConfig配置Python自定义logging类？

你之前在loggers节点里使用class或()参数是无效的，因为Python的logging.config.dictConfig规范中，loggers配置项仅用于设置日志器的级别、处理器、传播属性等，不支持直接指定自定义Logger类。日志器的创建逻辑由logging.getLogger()负责，默认使用全局的Logger类。

以下是几种可行的解决方案：

方案一：全局替换默认Logger类 #

如果你的自定义Logger类适用于所有日志器，可以在调用dictConfig前全局设置默认Logger类，这样所有通过getLogger()创建的日志器都会使用你的自定义类：

from my_app.logging import MyLogger
import logging

def init_logging() -> None:
    # 设置全局默认Logger类为自定义类
    logging.setLoggerClass(MyLogger)
    logging.config.dictConfig(LOGGING_CONF)

注意：这种方式会影响所有日志器（包括第三方库的），如果你的自定义类有特殊依赖或逻辑，需确认不会引发兼容问题。

方案二：手动创建并注册特定日志器 #

如果只想让my_app日志器使用自定义类，可以手动创建实例并注册到日志管理器中，避免全局影响：

from my_app.logging import MyLogger
import logging
import logging.config

def init_logging() -> None:
    # 先加载配置，初始化格式器、处理器等组件
    logging.config.dictConfig(LOGGING_CONF)
    
    # 创建自定义日志器实例
    my_logger = MyLogger("my_app")
    # 从配置中读取并应用属性
    logger_config = LOGGING_CONF["loggers"]["my_app"]
    my_logger.setLevel(logger_config["level"])
    my_logger.propagate = logger_config["propagate"]
    
    # 绑定配置好的处理器
    for handler_name in logger_config["handlers"]:
        # 获取已初始化的处理器（Python 3.10+可直接用logging.getHandlerByName）
        handler = logging.config._handlers.get(handler_name)
        if handler:
            my_logger.addHandler(handler)
    
    # 将自定义日志器注册到日志管理器，确保其他模块通过getLogger("my_app")能获取到它
    logging.getLogger("my_app").manager.loggerDict["my_app"] = my_logger

方案三：使用自定义日志器工厂（Python 3.10+） #

从Python 3.10开始，dictConfig支持loggerFactory参数，可指定工厂函数来控制日志器的创建逻辑，精准针对特定日志器使用自定义类：

1. 修改配置文件 #

在LOGGING_CONF中添加loggerFactory字段：

LOGGING_CONF: typing.Dict[str, typing.Any] = {
    "version": 1,
    "disable_existing_loggers": False,
    "loggerFactory": "my_app.logging.custom_logger_factory",  # 指定工厂函数路径
    "formatters": {
        # ... 原有格式器配置
    },
    "handlers": {
        # ... 原有处理器配置
    },
    "loggers": {
        # ... 原有日志器配置
    },
}

2. 实现工厂函数 #

在my_app/logging.py中定义工厂函数：

import logging
from typing import Optional

def custom_logger_factory(name: str, module: Optional[str] = None) -> logging.Logger:
    # 仅对"my_app"日志器使用自定义类
    if name == "my_app":
        from my_app.logging import MyLogger
        return MyLogger(name)
    # 其他日志器使用默认Logger类
    return logging.getLoggerClass()(name)

注意事项 #

自定义Logger类必须继承自logging.Logger，并正确实现构造函数：

import logging

class MyLogger(logging.Logger):
    def __init__(self, name: str, level: int = logging.NOTSET):
        super().__init__(name, level)
        # 在这里添加你的自定义逻辑，比如初始化数据库模型引用
        self.db_model = ...

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