如何在Django中启用日志？自定义Auth后端日志不显示排查

我来帮你一步步定位日志不显示的问题，咱们只聚焦在日志记录器和级别是否正常工作上，暂时忽略根日志器、ERROR级别不规范的问题。

第一步：先验证日志配置本身是否生效 #

先抛开Auth后端的逻辑，直接在代码里加一段简单的测试日志，确认你的日志配置能正常输出内容：

# 可以在settings.py末尾或者自定义Auth后端的文件顶部加这段测试代码
import logging
# 如果你用的是根日志器，就用这个
root_logger = logging.getLogger()
root_logger.debug("测试根日志器DEBUG级别")
root_logger.info("测试根日志器INFO级别")
root_logger.error("测试根日志器ERROR级别")

# 如果你打算用自定义日志器（比如当前模块的日志器），就用这个
module_logger = logging.getLogger(__name__)
module_logger.debug("测试模块日志器DEBUG级别")
module_logger.info("测试模块日志器INFO级别")
module_logger.error("测试模块日志器ERROR级别")

启动Django服务后，看控制台或者你配置的日志输出位置有没有这些测试内容。如果测试日志都不显示，那问题出在日志配置本身；如果测试日志能正常输出，再去排查Auth后端的日志调用逻辑。

第二步：确认自定义Auth后端的代码被执行到 #

有时候日志不显示，是因为你的Auth后端根本没被调用到。可以在认证方法里加个print语句验证：

class CustomAuthBackend:
    def authenticate(self, request, username=None, password=None):
        # 先加个print确认代码走到这一步
        print("自定义Auth后端的authenticate方法被触发了！")
        # 你的日志调用代码
        logger.error("这是认证时的测试日志")
        # 后续的认证逻辑...

如果控制台没看到print的内容，说明你的后端没被配置生效，记得在settings.py里添加：

AUTHENTICATION_BACKENDS = [
    '你的app名称.backends.CustomAuthBackend',  # 替换成你的后端路径
    'django.contrib.auth.backends.ModelBackend',  # 保留默认后端，避免影响其他认证逻辑
]

第三步：检查日志器与级别配置是否匹配 #

如果测试日志能输出，但Auth后端的日志不行，重点看这两点：

1. 日志器是否对应：你在Auth后端里调用的日志器，和配置里的日志器是不是同一个？比如你用了logging.getLogger()（根日志器），但配置里只给自定义日志器开了输出权限，那根日志器的内容就出不来。
2. 级别是否足够低：如果你的日志配置里设置的级别是INFO，那DEBUG级别的日志会被过滤；如果设置的是ERROR，那INFO和DEBUG都出不来。可以临时把配置里的级别调低到DEBUG测试：

# settings.py的LOGGING配置示例
LOGGING = {
    'version': 1,
    'disable_existing_loggers': False,
    'handlers': {
        'console': {
            'class': 'logging.StreamHandler',
        },
    },
    'loggers': {
        # 如果用根日志器，就配置这个
        '': {
            'handlers': ['console'],
            'level': 'DEBUG',  # 临时改成DEBUG
            'propagate': True,
        },
        # 如果用模块日志器，就配置你的app名称
        'your_auth_app': {
            'handlers': ['console'],
            'level': 'DEBUG',
            'propagate': True,
        },
    },
}

修改配置后记得重启Django服务，再测试日志是否输出。

第四步：检查日志调用的语法是否正确 #

最后确认你在Auth后端里的日志调用没有语法错误，比如有没有正确获取日志器、有没有写错日志方法：

# 错误示例：没获取日志器直接调用
logging.error("日志内容")  # 这其实是调用根日志器的方法，如果你配置的是自定义日志器，可能不生效

# 正确示例（如果用自定义日志器）
logger = logging.getLogger(__name__)
logger.error("日志内容")

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