生产环境 Django 日志不记录错误，通常是因为日志配置字典结构有误、文件权限不足或被 WSGI 服务器缓冲拦截，优先检查 settings.py 中的 LOGGING 配置项及日志文件写入权限。

命令速用版

如果是权限问题，可尝试快速修正文件归属（假设运行用户为 www-data）：

sudo mkdir -p /var/log/django && sudo touch /var/log/django/error.log && sudo chown -R www-data:www-data /var/log/django/

如果是配置缺失，确保 settings.py 中包含基础文件处理器（含轮转与格式）：

LOGGING = {
    'version': 1,
    'disable_existing_loggers': False,
    'formatters': {
        'verbose': {
            'format': '{levelname} {asctime} {module} {message}',
            'style': '{',
        },
    },
    'handlers': {
        'file': {
            'level': 'ERROR',
            'class': 'logging.handlers.RotatingFileHandler',
            'filename': '/var/log/django/error.log',
            'maxBytes': 1024*1024*5,
            'backupCount': 5,
            'formatter': 'verbose',
        },
    },
    'loggers': {
        'django': {
            'handlers': ['file'],
            'level': 'ERROR',
            'propagate': True,
        },
    },
}

为什么会这样

Django 内置了 Python 的 logging 模块，生产环境默认不会向控制台输出错误日志。如果配置中 disable_existing_loggers 被设为 True，可能会禁用根日志记录器；如果文件路径不存在或权限不足，FileHandler 会静默失败；此外，长期使用单文件处理器可能导致日志文件过大占用磁盘空间，且缺乏标准格式（时间、级别）会降低生产问题定位效率。

分步处理

1. 检查日志配置字典

打开 settings.py，确认 LOGGING 字典已定义。重点检查 handlers 中的 filename 路径是否绝对路径，以及 level 是否设置为 ERROR 或 INFO。生产环境建议配置 formatters 以确保日志包含时间戳和级别信息，并使用 RotatingFileHandler 进行日志轮转。

2. 验证文件权限

登录服务器，查看日志文件所属用户。运行 Django 的进程用户（如 www-data、nginx 或 gunicorn 配置的用户）必须对该文件有写入权限。如果文件不存在，确保其父目录可写。

ls -l /var/log/django/error.log
ps aux | grep gunicorn

3. 检查 WSGI 服务器配置

如果使用 Gunicorn，检查是否配置了 `--access-logfile` 和 `--error-logfile`。有时 Django 内部日志会流向服务器的错误日志文件，而不是 Django 配置的文件。

怎么验证是否生效

在终端使用 tail -f 监听日志文件，然后在浏览器访问一个故意报错的 URL（如不存在的管理后台页面）。

tail -f /var/log/django/error.log

如果配置生效，文件应立即滚动显示新的 traceback 信息，且包含明确的时间戳和错误级别。如果没有反应，检查 Django 进程是否已重载配置（可能需要重启服务）。

常见坑

• disable_existing_loggers: True 会禁用未显式配置的日志记录器，导致第三方库日志丢失。
• 日志文件路径所在的目录不存在，FileHandler 不会自动创建目录，会导致配置失效。
• 生产环境 DEBUG = False 时，Django 默认错误邮件配置可能未设置，导致错误仅记录日志不通知。
• 容器化部署时，日志写入容器内部文件而非挂载卷，重启后日志丢失。
• 未配置日志轮转，单一日志文件无限增长可能占满磁盘空间。
• 未配置 formatter，日志缺乏时间戳和级别，难以排查问题发生的具体时间点。

参考来源

• Django Official Documentation, "Logging", https://docs.djangoproject.com/en/stable/topics/logging/