如何配置Django日志避免干扰manage.py命令的输出？

问题背景 #

当前Django日志配置在Gunicorn运行时可正常输出到指定日志文件，但执行poetry run python manage.py sqlflush等命令时，应用的logger.info()日志会与命令生成的SQL输出混杂在控制台，同时希望将Gunicorn和Django应用的所有日志统一存储到单个文件。

解决方案 #

1. 调整Django日志配置，支持环境变量控制输出 #

修改settings.py中的日志配置，添加文件日志处理器，并通过环境变量区分运行场景（生产环境/Gunicorn、manage命令）：

import os
from pathlib import Path

# 统一日志文件路径，确保目录存在
LOG_FILE = Path("/var/log/myapp/myapp.log")
LOG_FILE.parent.mkdir(parents=True, exist_ok=True)

LOGGING = {
    'version': 1,
    'disable_existing_loggers': False,
    'formatters': {
        'app_verbose': {
            'format': '%(asctime)s [%(levelname)s] %(name)s %(module)s %(process)d %(thread)d %(message)s'
        },
        'gunicorn_format': {
            'format': '%(asctime)s [%(levelname)s] [gunicorn] %(message)s'
        }
    },
    'handlers': {
        'console': {
            'class': 'logging.StreamHandler',
        },
        'unified_file': {
            'class': 'logging.handlers.RotatingFileHandler',
            'filename': LOG_FILE,
            'maxBytes': 5*1024*1024,  # 单文件最大5MB
            'backupCount': 5,  # 保留5个备份文件
            'formatter': 'app_verbose',
            'encoding': 'utf-8'
        }
    },
    'loggers': {
        # 根日志器：根据环境变量选择输出目标
        '': {
            'handlers': ['unified_file'] if os.getenv('RUN_ENV') == 'production' else ['console'],
            # 执行manage命令时，可通过环境变量降低日志级别，避免info日志干扰
            'level': 'WARNING' if os.getenv('MANAGE_QUIET_LOG') == 'True' else 'INFO',
            'propagate': True
        },
        # 单独配置Gunicorn日志，统一写入文件
        'gunicorn': {
            'handlers': ['unified_file'],
            'level': 'DEBUG',
            'formatter': 'gunicorn_format',
            'propagate': False
        },
        'gunicorn.access': {
            'handlers': ['unified_file'],
            'level': 'INFO',
            'formatter': 'gunicorn_format',
            'propagate': False
        }
    }
}

2. 修改Gunicorn配置，复用统一日志文件 #

更新Gunicorn配置文件，禁用单独的access/error日志，改用统一的日志文件：

bind = "0.0.0.0:50000"
workers = 1
worker_class = "gthread"
threads = 2
worker_connections = 1000
timeout = 60
keepalive = 5
loglevel = "debug"
capture_output = True

# 注释原有单独日志文件配置
# accesslog = "/var/log/gunicorn/myapp.com-access.log"
# errorlog = "/var/log/gunicorn/myapp.com-error.log"

# 配置Gunicorn日志写入统一文件
logconfig_dict = {
    'version': 1,
    'disable_existing_loggers': False,
    'formatters': {
        'gunicorn_format': {
            'format': '%(asctime)s [%(levelname)s] [gunicorn] %(message)s'
        }
    },
    'handlers': {
        'unified_file': {
            'class': 'logging.handlers.RotatingFileHandler',
            'filename': "/var/log/myapp/myapp.log",
            'maxBytes': 5*1024*1024,
            'backupCount': 5,
            'formatter': 'gunicorn_format',
            'encoding': 'utf-8'
        }
    },
    'loggers': {
        'gunicorn': {
            'handlers': ['unified_file'],
            'level': 'DEBUG',
            'propagate': False
        },
        'gunicorn.access': {
            'handlers': ['unified_file'],
            'level': 'INFO',
            'propagate': False
        }
    }
}

3. 运行时的命令调整 #

• 启动Gunicorn：设置RUN_ENV=production，让Django日志写入统一文件：

  RUN_ENV=production poetry run gunicorn myapp.wsgi:application -c gunicorn_config.py
  

• 执行manage命令：设置MANAGE_QUIET_LOG=True，屏蔽info级日志，仅保留warning及以上日志，避免干扰命令输出：

  MANAGE_QUIET_LOG=True poetry run python manage.py sqlflush
  

  如果需要查看manage命令的应用日志，去掉该环境变量即可。

效果说明 #

• Gunicorn运行时，Django应用日志和Gunicorn的访问/错误日志都会写入/var/log/myapp/myapp.log，实现统一存储。
• 执行manage命令时，控制台仅输出命令本身的结果（如SQL语句），应用的info日志不会干扰；若需要调试，可取消环境变量查看完整日志。

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