能否让Django按客户端/会话分配固定持久化PostgreSQL数据库连接？

开发者阿泽

2026-5-22

当然可以实现这个需求！下面我会一步步拆解怎么让Django或者配合pgBouncer来给每个客户端/会话绑定固定的PostgreSQL连接：

1. 利用Django的连接复用+自定义会话绑定

Django的CONN_MAX_AGE确实能帮你减少连接建立的开销，它默认是让每个线程复用同一个数据库连接（如果用WSGI服务器的多线程模式）。但如果要精准绑定到用户会话，你需要做一点自定义改造：

首先在settings.py里设置合理的CONN_MAX_AGE值，比如设为3600（1小时），既保证复用效率，又避免连接长时间闲置被PostgreSQL主动断开：

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': 'your_db',
        'USER': 'your_user',
        'PASSWORD': 'your_pass',
        'HOST': 'localhost',
        'PORT': '5432',
        'CONN_MAX_AGE': 3600,
    }
}

然后写一个自定义中间件，把当前请求的数据库连接和用户会话绑定。核心思路是：请求开始时，检查会话里是否有保存的连接标识，有就尝试复用；没有就新建连接并把标识存入会话。不过要注意，Django的数据库连接是线程本地存储的，如果你的服务器用的是多进程模式（比如Gunicorn的pre-fork），线程隔离会让这个方案的效果打折扣，这时候更推荐用专门的连接池工具。

2. 用pgBouncer的会话池模式（Session Pooling）

pgBouncer的会话池模式完全匹配你的需求：每个客户端会话会一直持有同一个PostgreSQL连接，直到客户端主动断开。这比Django自己的复用逻辑更可靠，因为它是在连接池层面直接管理会话与连接的绑定关系。

配置pgBouncer的pool_mode为session（这是默认值，但显式设置更清晰），修改pgbouncer.ini：

[databases]
your_db = host=localhost port=5432 dbname=your_db

[pgbouncer]
listen_addr = *
listen_port = 6432
auth_type = md5
auth_file = userlist.txt
pool_mode = session
max_client_conn = 1000
default_pool_size = 20

调整Django的数据库配置，把连接目标从PostgreSQL改成pgBouncer：

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': 'your_db',
        'USER': 'your_user',
        'PASSWORD': 'your_pass',
        'HOST': 'localhost',
        'PORT': '6432',  # 指向pgBouncer的监听端口
        'CONN_MAX_AGE': 3600,  # 保持Django的连接复用，减少和pgBouncer的连接建立开销
    }
}

这样设置后，同一个用户会话的所有Django请求，都会通过pgBouncer复用同一个PostgreSQL连接，直到会话结束或者连接超时。

3. 关键注意事项

避免连接泄漏：用会话池模式时，要确保客户端会话结束后连接能被正确释放。Django在请求结束时会把连接放回内部池（当CONN_MAX_AGE>0时），pgBouncer则会继续持有这个连接直到会话断开。
配置PostgreSQL的闲置超时：建议在PostgreSQL的postgresql.conf里设置idle_in_transaction_session_timeout = 30000（30秒），防止长时间处于闲置状态的事务占用连接资源。
适配异步环境：如果用的是异步Django（ASGI），要确保使用兼容的数据库后端，比如psycopg3的异步引擎，同时pgBouncer的配置也要适配异步连接的特性。

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