Django中PostgreSQL连接池配置无效及验证方法咨询

一、修复连接池配置错误 #

你当前的配置存在关键问题：CONN_MAX_AGE是Django数据库配置的顶层参数，不属于OPTIONS字典（OPTIONS里的参数是直接传给psycopg2驱动的），这是导致连接池不生效的核心原因。

正确的配置示例：

import psycopg2
from psycopg2.extensions import ISOLATION_LEVEL_READ_COMMITTED

DATABASES = {
    "default": {
        "ENGINE": "django.db.backends.postgresql_psycopg2",
        "NAME": env("POSTGRES_DB"),
        "USER": env("POSTGRES_USER"),
        "PASSWORD": env("POSTGRES_PASSWORD"),
        "HOST": env("POSTGRES_HOST"),
        "PORT": env("POSTGRES_PORT"),
        "CONN_MAX_AGE": 600,  # 移到顶层，设置连接最大存活时间（秒）
        'OPTIONS': {
            'isolation_level': ISOLATION_LEVEL_READ_COMMITTED,
            # 移除OPTIONS里的conn_max_age
        },
    }
}

说明：

• CONN_MAX_AGE设置为600表示连接最多存活10分钟，到期后会被关闭并重新创建；设为None则连接永久复用（但需注意数据库端可能会主动回收闲置连接）。
• 生产环境建议设置300-1800秒，平衡连接复用率和连接新鲜度。

二、验证连接池是否生效 #

1. 查看PostgreSQL实时连接数 #

登录PostgreSQL数据库，执行SQL查询：

SELECT count(*) FROM pg_stat_activity WHERE datname = '你的数据库名称';

操作步骤：

• 先记录初始连接数；
• 多次发起Django应用请求（刷新页面、调用接口）；
• 再次查询连接数。
  如果连接数没有随请求数持续暴涨，而是稳定在一定数值（通常和WSGI进程/线程数匹配），说明连接被复用，池化生效。

2. 开发环境调试验证 #

开启DEBUG=True后，可通过代码打印连接ID：

from django.db import connection

# 在视图函数中添加
print(f"当前连接ID: {connection.connection_id}")

发起多个请求，若在CONN_MAX_AGE有效期内，不同请求出现相同的connection_id，说明连接被复用。

3. 查看Django数据库日志 #

在settings.py中配置日志：

LOGGING = {
    'version': 1,
    'disable_existing_loggers': False,
    'handlers': {
        'console': {'class': 'logging.StreamHandler'},
    },
    'loggers': {
        'django.db.backends': {
            'handlers': ['console'],
            'level': 'DEBUG',
        },
    },
}

运行应用后，观察控制台日志：只有在初始化或连接过期时才会出现"New connection to database '<数据库名>'"的日志，后续请求不再频繁生成该日志，说明连接池正常工作。

4. 压测验证 #

使用压测工具（如ab、locust）对接口发起高频请求，同时监控PostgreSQL连接数。若连接数保持稳定，未随请求量线性增长，即可确认连接池生效。

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