配置Django自定义日志Handler时出现配置失败错误的原因

错误核心原因 #

Django启动时会优先初始化日志系统，此时数据库ORM框架还未完成初始化。你的DatabaseHandler在模块顶部直接导入了Log模型，导致模型加载失败，进而无法完成handler的配置，最终抛出ValueError: Unable to configure handler 'database'。

具体问题点及修复方案 #

1. 模块顶部提前导入模型导致初始化顺序冲突 #

问题代码（log.py）：

import logging
from .models import Log  # 模块加载时就导入模型，此时Django ORM未初始化

class DatabaseHandler(logging.Handler):
    def emit(self, record):
        log = self.format(record)
        level = record.levelname
        message = record.getMessage()
        Log.objects.create(level=level, message=message)

修复方案：将模型导入延迟到emit方法内部，确保调用时ORM已初始化：

import logging

class DatabaseHandler(logging.Handler):
    def emit(self, record):
        from .models import Log  # 延迟导入，规避初始化顺序问题
        log = self.format(record)
        level = record.levelname
        message = record.getMessage()
        Log.objects.create(level=level, message=message)

2. 日志配置拼写错误 #

问题代码（settings.py）：

'loggers': {
    'main': {
        'handlers': ['database'],
        'level': 'DEBUG',
        'propogate':True  # 拼写错误，正确应为propagate
    }
},

修复方案：修正拼写：

'loggers': {
    'main': {
        'handlers': ['database'],
        'level': 'DEBUG',
        'propagate': True
    }
},

3. 避免重复添加Handler #

问题代码（log.py）：

logger = logging.getLogger(__name__)
logger.setLevel(logging.DEBUG)
handler = DatabaseHandler()
formatter = logging.Formatter('%(levelname)s %(message)s')
handler.setFormatter(formatter)
logger.addHandler(handler)

这段代码会手动给当前模块的logger添加Handler，而settings.py中已经配置了全局日志系统，会导致重复记录日志。

修复方案：删除这段手动初始化代码，完全通过settings.py的LOGGING配置管理日志。

验证修复 #

修改完成后重新启动项目，日志系统会正常初始化，DatabaseHandler可正常将日志写入数据库。

内容的提问来源于stack exchange，提问作者Артём Ивасенко