django-request 常见问题排查清单10 个高频错误与解决方案【免费下载链接】django-requestdjango-request is a statistics module for django. It stores requests in a database for admins to see, it can also be used to get statistics on who is online etc.项目地址: https://gitcode.com/gh_mirrors/dj/django-requestdjango-request 是一个开源的 Django 请求统计模块它会把每一次 HTTP 请求写入数据库让管理员在后台直接查看流量走势、在线用户、来源页面、搜索引擎关键词和错误页面等数据。然而新手在安装配置 django-request 时经常碰到请求不记录表不存在IP 全是 1.1.1.1之类的问题。这份 django-request 常见问题排查清单整理了 10 个最高频的错误现象、根因和解决方案帮你少走弯路。一、10 个高频错误速查表现象主要原因快速解法后台看不到任何请求没加中间件或没迁移检查MIDDLEWARE与migrate报错 relation request_request does not exist忘记执行迁移执行migrateuser 字段永远为空中间件顺序不对放到AuthenticationMiddleware之后404 全被当成错误页与 flatpages 顺序冲突放到FlatpageFallbackMiddleware之前ModuleNotFoundError: dateutil缺依赖安装python-dateutilIP 全是 1.1.1.1日志脱敏配置开启检查REQUEST_LOG_IP等站内跳转算成外链未设置REQUEST_BASE_URL在 settings 中补上站点地址数据库越来越大无清理机制用purgerequests命令只想存错误却全存了未开启错误过滤开启REQUEST_ONLY_ERRORS在线用户列表为空模板标签用法有误检查active_users参数二、10 个高频错误详解1. 安装后没有任何请求被记录这是最常见的问题数据表建好了后台也有菜单但一条记录都没有。原因通常是漏掉了中间件。django-request 依赖中间件在每次响应后写入数据仅加入INSTALLED_APPS是不够的。在settings.py中确认包含INSTALLED_APPS里加入requestMIDDLEWARE里加入request.middleware.RequestMiddleware并且已执行过manage.py migrate。2. ProgrammingError: relation request_request does not exist页面直接报数据库表不存在本质是没有执行迁移。request应用自带多份迁移文件位于request/migrations/安装后必须执行python manage.py migrate如果依然报错检查INSTALLED_APPS中的应用名是否写成了别的例如django-requestDjango 只认request。3. 记录里 user 字段永远是空的日志能看到请求但登录用户那一列始终是空值。这通常是中间件顺序错误RequestMiddleware被放在了django.contrib.auth.middleware.AuthenticationMiddleware之前此时request.user还没被注入。正确的顺序是MIDDLEWARE [ # ... django.contrib.auth.middleware.AuthenticationMiddleware, request.middleware.RequestMiddleware, # ... ]4. 404 页面全部被记录成错误页如果项目使用了django.contrib.flatpages扁平页你会看到大量本应正常返回的页面被标记为 404 错误。原因是FlatpageFallbackMiddleware会先把请求吃掉再重新返回导致状态码判断错位。解法是让RequestMiddleware排在FlatpageFallbackMiddleware之前让请求先被记录、再交给 flatpages 处理。5. ModuleNotFoundError: No module named dateutil启动或迁移时抛出找不到dateutil是因为缺少核心依赖python-dateutil。request/managers.py中的按年、按月、按周统计都依赖它。安装方式pip install python-dateutil如果是源码部署也建议用pip install -e .让依赖自动补齐或直接通过 GitCode 克隆仓库后本地安装git clone https://gitcode.com/gh_mirrors/dj/django-request cd django-request pip install -e .6. 所有 IP 都显示为 1.1.1.1日志里 IP 清一色是1.1.1.1大概率不是 bug而是隐私脱敏配置生效了。相关开关集中在request/settings.pyREQUEST_LOG_IP False不记录真实 IP统一替换为REQUEST_IP_DUMMY默认1.1.1.1REQUEST_ANONYMOUS_IP True把 IP 最后一段置为 1例如192.168.1.1变成192.168.1.1之外的*.*.*.1形式。按需关闭或调整这两个配置即可。若你希望完全符合 GDPR 等隐私规范保留匿名化反而是推荐做法。7. 站内跳转被当成外链统计严重失真外部来源和独立访问数字虚高原因是没有设置REQUEST_BASE_URL。该值用于判断 referer 是否来自本站默认取django.contrib.sites的当前站点域名如果站点用了 HTTPS、多域名或未启用 sites 框架判断就会失效。在settings.py中显式指定REQUEST_BASE_URL https://www.example.com/这样unique_visits()等方法才能正确排除站内来源。8. 数据库膨胀、后台列表越来越慢django-request 会记录每一次请求高流量站点一个月就能攒下几十万行导致后台变卡、备份变慢。官方提供了清理命令purgerequests逻辑见request/management/commands/purgerequests.py。用法示例删除 30 天前的记录跳过确认python manage.py purgerequests 30 days --noinput支持hours、days、weeks、months、years五种单位建议配合 cron 定时执行。9. 只想记录错误请求结果全部请求都被存下来了如果只是想用 django-request 当错误监控把全部请求入库既浪费存储又淹没重点。开启错误过滤即可REQUEST_ONLY_ERRORS True开启后只有返回状态码 ≥ 400 的响应会被记录判断逻辑见request/middleware.py。同理REQUEST_VALID_METHOD_NAMES可以限定只记录 GET/POST 等指定方法过滤掉 OPTIONS、TRACE 等噪音。10. active_users 在线用户列表永远是空的模板里用了active_users标签却拿不到数据常见原因有三个忘记{% load request_tag %}导致标签未注册用户未登录该功能只统计user非空的记录匿名访客不算在线时间窗口太短默认只统计最近 15 分钟可这样调整{% load request_tag %} {% active_users in 30 minutes as online_users %} {% for user in online_users %}{{ user.get_username }}{% endfor %}标签实现见request/templatetags/request_tag.py对应管理器方法为Request.objects.active_users(minutes30)位于request/managers.py。三、常用配置速查配置项默认值作用REQUEST_ONLY_ERRORSFalse只记录错误响应REQUEST_IGNORE_AJAXFalse忽略 AJAX 请求REQUEST_IGNORE_IP()忽略指定 IPREQUEST_IGNORE_PATHS()用正则忽略路径如r^admin/REQUEST_IGNORE_USER_AGENTS()忽略爬虫等 UAREQUEST_LOG_IP/REQUEST_ANONYMOUS_IPTrue / False控制 IP 是否脱敏REQUEST_BASE_URLsites 域名站内来源判断基准完整的配置说明可查阅仓库内docs/settings.txt模型字段与存储逻辑见request/models.py。结语django-request 的坑大多集中在安装三件套应用注册、迁移、中间件顺序和统计口径配置上。把上面 10 条逐个对照检查大部分问题都能在五分钟内解决。如果排查后仍有异常优先检查 Django 日志中的request.security.middleware警告它能直接告诉你哪些请求因校验失败被丢弃。祝你顺利跑通自己的流量统计面板 【免费下载链接】django-requestdjango-request is a statistics module for django. It stores requests in a database for admins to see, it can also be used to get statistics on who is online etc.项目地址: https://gitcode.com/gh_mirrors/dj/django-request创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考