Django实现自定义访问日志中间件的方法

陈默

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

原创

本文介绍如何在Django中通过自定义Middleware实现访问日志功能。无需额外模块，只需创建middleware.py并注册到settings.py的MIDDLEWARE_CLASSES中，即可记录请求路径、IP及User-Agent等关键信息。

本文详细介绍利用Django框架开发自定义访问日志模块的具体实现方案，旨在为开发者提供可参考的实践案例。

Django原生并未内置专门的访问日志模块，但开发者可以利用Django提供的Middleware机制，自行构建一个满足需求的访问日志记录功能。

首先，需要在Django工程目录下新建一个名为middleware.py的文件，其具体代码实现如下所示。

#!/usr/bin/env python
# -*- coding: utf-8 -*-
import time
class AccessMiddleware(object):
  def process_request(self, request):
    meta = request.META
    print "[%s] PATH_INFO=%s, REMOTE_ADDR=%s, HTTP_USER_AGENT=%s" \
       %(time.strftime("%Y-%m-%d %H:%M:%S", time.localtime()),
        meta['PATH_INFO'], meta['REMOTE_ADDR'], meta['HTTP_USER_AGENT'])
    return None
  def process_response(self, request, response):
    return response

在该中间件类中，process_request() 方法的返回值必须为 None 或者一个 HttpResponse 对象。

若该方法返回 None，Django框架将继续处理当前的 request 请求，依次执行后续配置的中间件，并最终调用对应的 view 视图函数。

若该方法返回一个 HttpResponse 对象，Django 将停止执行任何其他的中间件（无论其类型为何）以及对应的 view 视图，并立即返回该 HttpResponse 对象。

接下来，需要修改 settings.py 配置文件，在 MIDDLEWARE_CLASSES 配置项中添加刚才创建的 AccessMiddleware 中间类，具体位置参考代码最后一行。

MIDDLEWARE_CLASSES = (
  'django.contrib.sessions.middleware.SessionMiddleware',
  'django.middleware.common.CommonMiddleware',
  'django.middleware.csrf.CsrfViewMiddleware',
  'django.contrib.auth.middleware.AuthenticationMiddleware',
  'django.contrib.auth.middleware.SessionAuthenticationMiddleware',
  'django.contrib.messages.middleware.MessageMiddleware',
  'django.middleware.clickjacking.XFrameOptionsMiddleware',
  'django.middleware.security.SecurityMiddleware',
  'commons.middleware.AccessMiddleware',
)

完成配置后重启 Django 服务，随后访问网站的任意页面，即可在控制台或日志输出中看到相应的访问日志记录。

更多关于Python相关内容感兴趣的读者可查看本站专题：《Python日志操作技巧总结》、《Python数据结构与算法教程》、《Python函数使用技巧总结》、《Python字符串操作技巧汇总》及《Python入门与进阶经典教程》

希望本文所述对大家Python程序设计有所帮助。