django默认不复用数据库连接,因每次请求结束即关闭连接以防止泄漏和污染,但会带来tcp/tls/认证开销;可通过conn_max_age启用有限复用,需配合数据库服务端参数及部署配置协同优化。

为什么Django默认不复用数据库连接
Django的数据库连接在每次请求结束时默认关闭,这是为了防止连接泄漏和状态污染,但对高并发短请求场景(比如API服务)会造成明显握手开销——每次connect()都触发TCP三次握手 + TLS协商(若启用SSL)+ PostgreSQL/MySQL认证流程。Django 4.2本身不提供“长连接池”能力,它依赖底层数据库驱动(如psycopg2或mysqlclient)的连接复用机制,而默认配置下这些驱动并不开启连接池。
用CONN_MAX_AGE控制连接复用生命周期
CONN_MAX_AGE是Django唯一原生支持的连接持久化开关,它控制单个连接在关闭前可被复用的最大秒数。设为0(默认)表示每个请求后立即关闭;设为None表示无限复用(不推荐);设为正整数(如60)表示连接最多空闲60秒后才关闭。
- 生产环境建议从
CONN_MAX_AGE = 60起步,观察连接数增长和超时错误 - 必须配合数据库服务端的
wait_timeout(MySQL)或tcp_keepalives_idle(PostgreSQL)参数,否则连接可能被服务端主动断开导致OperationalError: server closed the connection unexpectedly - 使用gunicorn/uwsgi时,需确保worker进程复用同一连接——这意味着不能用
--preload模式加载Django,否则所有worker共享初始连接句柄,引发并发冲突
psycopg2连接池替代方案(PostgreSQL专用)
若需要更精细的连接池控制(如最小/最大连接数、连接验证),Django自身不提供,得绕过ORM直接管理连接池。常用做法是用psycopg2.pool.ThreadedConnectionPool或sqlalchemy.pool.QueuePool,但要注意:这类池子无法被Django事务上下文自动感知,transaction.atomic()可能失效。
- 推荐方案:改用
django-db-geventpool(适配gevent)或django-postgres-pool(仅PostgreSQL),它们会patch Django的DatabaseWrapper,让CONN_MAX_AGE与池子协同工作 - 若自行实现,务必在
close_old_connections()调用前检查连接健康性,否则空闲连接可能已断开却未被清理 - 避免在
settings.py中直接初始化池子——Django多进程下每个worker需独立池实例,应在ready()信号或中间件中懒加载
MySQL连接复用的额外注意事项
MySQL驱动(mysqlclient)对CONN_MAX_AGE的支持较弱,容易因服务端wait_timeout(默认8小时)与客户端空闲时间不一致导致Lost connection to MySQL server during query。
- 必须同步设置MySQL服务端参数:
wait_timeout = 300(5分钟),并让CONN_MAX_AGE略小于该值(如240) -
mysqlclient不自动发送ping()保活,需手动在DATABASES配置中加入'OPTIONS': {'init_command': 'SET SESSION wait_timeout=240;'}(仅部分版本支持) - 更稳妥的做法是禁用
CONN_MAX_AGE,改用mysql-connector-python驱动,并启用其pool_size和pool_reset_session选项
ConnectionResetError。Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











