Django 默认不启用连接池，所谓“连接池超时”实为服务端断连后复用旧连接导致的错误；应通过 CONN_MAX_AGE=0 或信号钩子调用 close_if_unusable_or_obsolete() 主动清理失效连接。
直接说结论：Django 默认不启用连接池，所谓“连接池超时”问题，90% 是误判——实际是连接被服务端主动断开后，Django 仍尝试复用旧连接导致的 OperationalError: MySQL server has gone away 或 ConnectionResetError。真要用连接池，得靠第三方库（如 django-db-geventpool）或底层驱动显式配置。
为什么 Django 没有原生连接池？
Django 的数据库连接模型是 request-scoped 的：每个 HTTP 请求开始时获取新连接，结束后调用 close()。它不维护长生命周期连接池，也不复用连接。这意味着：
- 你看到的“连接池超时”，其实是连接空闲太久被 MySQL / PostgreSQL 主动关闭（默认 wait_timeout=28800 秒，但中间件如 PgBouncer 或云数据库常设为 300 秒）
-
DATABASES配置里加'POOL_OPTIONS': {...}是无效的——Django 官方不识别该字段 - SQLAlchemy 或 asyncpg 的池参数（如
max_size、pool_recycle）对纯 Django ORM 不起作用
如何让 Django 正确处理“被断开的连接”？
核心思路不是加池，而是及时发现并丢弃失效连接。Django 提供了信号机制和内置检测逻辑，关键在两处：
- 启用
CONN_MAX_AGE = 0（默认值）：强制每个请求用完即关，避免复用风险；若设为 >0（如60），必须配套健康检查，否则极易出错 - 注册
request_started和request_finished信号，调用conn.close_if_unusable_or_obsolete() - 在
settings.py同级目录（如apps.py或ready.py）中写：
from django.db import connections
from django.core.signals import request_started, request_finished
def close_old_connections(**kwargs):
for conn in connections.all():
conn.close_if_unusable_or_obsolete()
request_started.connect(close_old_connections)
request_finished.connect(close_old_connections)
这个钩子会自动检查连接是否超时、是否被服务端关闭，并在下次使用前清理掉。
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
立即学习“Python免费学习笔记（深入）”；
真要上连接池？选对方案再动手
如果你确实需要连接复用（比如高并发 API 服务 + gevent/uwsgi + MySQL），不要硬改 Django，而应选适配方案：
- 同步场景（uWSGI + gevent）：用
django-db-geventpool，它替换mysqlclient底层，支持MAX_CONNS、MIN_CONNS、RECYCLE_SECONDS等真实池参数 - 异步场景（FastAPI/Starlette + Django ORM）：Django 4.1+ 支持异步视图，但 DB 层仍同步；此时建议换
asyncpg+aiomysql自建池，绕过 Django ORM - 别碰
django-db-connection-pool这类已归档项目：无维护、不兼容 Python 3.12+、与 Django 5.x 冲突
注意：psycopg2 的 connect_timeout、options='-c tcp_keepalives_idle=60' 这类参数，只能在 OPTIONS['cursorclass'] 或驱动直连时生效，Django 的 OPTIONS 字典里传进去不会自动透传。
最容易被忽略的三个点
很多团队卡在最后一步：
- 没检查数据库侧的
wait_timeout和interactive_timeout，只调 Django 配置——结果池里一堆“僵尸连接” - 用了
CONN_MAX_AGE = 60却没配pool_recycle或心跳 SQL（如init=lambda conn: conn.cursor().execute("SELECT 1")），连接在第 61 秒必崩 - Python 3.12+ 下，
asyncpg池在未设server_settings={"tcp_keepalives_idle": "60"}时，TCP keepalive 由内核默认 7200 秒触发，中间代理早把连接清掉了
