Django框架配置Logging日志模块及调用方法

Luna

发布时间：2026-10-13 | 5人浏览过

原创

本文介绍如何在Django项目中通过配置settings.py启用logging模块，实现系统日志记录。内容涵盖日志格式、文件处理器的设置，以及在View中调用logger记录不同级别日志的具体代码示例，帮助开发者完善应用日志功能。

Django日志配置与调用指南

本文详细介绍在Python Django框架中集成logging日志功能的具体实现方法，供开发者参考使用。

Django框架基于Python内置的logging模块来执行系统日志记录任务。

尽管Django默认使用Python的内建日志模块，但若要在Django应用中开启此功能，将特定操作记录到日志文件中，必须进行相应的配置，并根据具体的日志类型进行调用。

第一步：配置settings.py文件。

以下配置代码中，除filename（日志文件路径）和formatters（日志格式）需根据实际环境调整外，其余部分可保持不变。


LOGGING = {
  'version': 1,
  'disable_existing_loggers': False,#此选项开启表示禁用部分日志，不建议设置为True
  'formatters': {
    'verbose': {
      'format': '%(levelname)s %(asctime)s %(message)s'#日志格式
    },
    'simple': {
      'format': '%(levelname)s %(message)s'
    },
  },
  'filters': {
    'require_debug_true': {
      '()': 'django.utils.log.RequireDebugTrue',#过滤器，只有当setting的DEBUG = True时生效
    },
  },
  'handlers': {
    'console': {
      'level': 'DEBUG',
      'filters': ['require_debug_true'],
      'class': 'logging.StreamHandler',
      'formatter': 'verbose'
    },
    'file': {#重点配置部分
      'level': 'DEBUG',
      'class': 'logging.FileHandler',
      'filename': '/home/lockey23/myapp/myapp/debug.log',#日志保存文件
      'formatter': 'verbose'#日志格式，与上边的设置对应选择
        }
  },
  'loggers': {
    'django': {#日志记录器
      'handlers': ['file'],
      'level': 'DEBUG',
      'propagate': True,
    }
  },
}

第二步：在实际代码中调用日志功能。

例如，若需要在某些View视图中调用logger来记录用户操作，可以参考如下代码实现。


import logging
logger = logging.getLogger('django')#这里的日志记录器要和setting中的loggers选项对应，不能随意给参
#接下来就是调用了：
logger.debug('[Debug] '+ msg)
logger.info('[Success] '+ msg)
logger.warning('[Warning] '+ msg)
logger.error('[Error] '+ msg)
logger.critical('[Critical] '+ msg)
......
if auth_pass:
  logger.info('[Success] '+ user +' has logged in!')
  return JsonResponse({'result': 'Success', 'message': 'Login successfully.'})
else:
  logger.warning('[Failed] '+ user + ' failed to login!')

希望本文提供的Django框架Python程序设计日志配置方案能对读者有所帮助。