升级至Django 4后数据库空闲连接过多问题求助

核心问题背景 #

升级Django 4.0后出现PostgreSQL连接耗尽错误：

FATAL: remaining connection slots are reserved for non-replication superuser connections.

设置CONN_MAX_AGE=60未生效，部分连接长期空闲不释放；CONN_MAX_AGE=0可解决但会带来性能损耗，更换ASGI服务器、移除Channels均无法根治问题。

针对性修复方案 #

1. 开启数据库连接健康检查 #

Django 4.0对连接池逻辑做了调整，开启健康检查可强制清理失效/长期空闲的连接：

DATABASES = {
    'default': {
        # 原有数据库配置
        'CONN_MAX_AGE': 60,
        'CONN_HEALTH_CHECKS': True,
    }
}

该配置会在复用连接前验证有效性，同时自动回收超出CONN_MAX_AGE的连接。

2. 异步场景下手动管理连接 #

如果项目包含异步视图或异步任务，Django 4.0的异步连接管理存在兼容问题，需手动绑定连接上下文：

from django.db import connections

async def my_async_view(request):
    async with connections['default'].acquire():
        # 执行数据库操作
        pass

确保连接在异步任务结束后被正确释放，避免长期持有。

3. 配置PostgreSQL主动回收闲置连接 #

作为兜底方案，修改PostgreSQL配置（postgresql.conf），让数据库主动清理超时闲置连接：

idle_in_transaction_session_timeout = 60000  # 1分钟，与CONN_MAX_AGE时长对齐

该参数会关闭超过1分钟的闲置事务连接，避免连接池无限制积压。

4. 排查第三方库的连接持有问题 #

部分第三方ORM扩展、工具库可能未适配Django 4.0的连接管理逻辑：

• 检查所有数据库相关依赖的版本，确保与Django 4.0兼容；
• 调用第三方库后手动强制关闭过期连接：

  from django.db import close_old_connections
  
  def third_party_operation():
      # 第三方库操作逻辑
      close_old_connections()
  

5. 升级到Django稳定版 #

Django 4.0.8存在已知的连接池泄漏bug，后续LTS版本（如4.2+）已修复相关问题，直接升级可彻底解决连接泄漏问题。

验证方法 #

• 使用PostgreSQL命令查看当前连接状态，确认是否有长期未释放的连接：

  SELECT pid, datname, usename, state, query_start FROM pg_stat_activity;
  

  重点关注state为idle in transaction且query_start超时的连接。
• 开启Django数据库日志，监控连接的创建、复用、销毁流程：

  LOGGING = {
      # 原有日志配置
      'loggers': {
          'django.db.backends': {
              'level': 'DEBUG',
              'handlers': ['console'],
          },
      }
  }
  

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