Django测试报OperationalError：测试数据库被其他会话占用

这问题我之前在多线程数据库场景里碰到过，本地测试没问题是因为并发量低，服务器上线程数上来后，会话资源的冲突就暴露出来了。我帮你拆解下核心原因和可行的解决方案：

可能的核心诱因 #

• 线程不安全的连接复用：绝大多数Python数据库驱动（比如psycopg2、MySQLdb）的连接对象都不是线程安全的，如果你的线程函数和目标函数共用同一个DB连接实例，多个线程同时操作会打乱会话状态，数据库就会判定有大量活跃会话占用资源。
• 未正确释放会话资源：线程里的数据库操作如果没及时提交/回滚事务，或者操作完成后没关闭连接（或归还给连接池），会导致会话一直处于活跃挂起状态，积累到10个就触发了数据库的连接数限制。
• 连接池配置不匹配线程规模：如果用了连接池但设置的最大连接数小于线程数量，线程会争抢有限的连接资源，导致部分请求被阻塞，进而出现「被其他用户访问」的错误提示。

针对性解决方案 #

1. 给每个线程分配独立的数据库连接 #

绝对不要在多个线程之间共享连接对象，推荐用threading.local()来存储每个线程专属的连接实例：

import threading
import psycopg2

# 线程本地存储容器，每个线程拥有独立的连接副本
thread_local = threading.local()

def get_db_connection():
    if not hasattr(thread_local, "conn"):
        # 为当前线程创建专属连接
        thread_local.conn = psycopg2.connect(
            dbname="test_ebdb",
            user="your_username",
            password="your_password",
            host="your_db_host"
        )
    return thread_local.conn

# 线程函数中的数据库操作示例
def cache_update_thread():
    conn = get_db_connection()
    try:
        with conn.cursor() as cur:
            cur.execute("SELECT * FROM target_table WHERE ...")
            # 处理查询结果并更新缓存
            conn.commit()
    except Exception as e:
        # 出错必须回滚，避免会话挂起
        conn.rollback()
        raise e
    # 如果是一次性线程，退出前记得关闭连接
    # thread_local.conn.close()
    # del thread_local.conn

2. 严格管控事务和连接生命周期 #

不管操作成功还是失败，一定要确保事务被提交或回滚，绝对不能让会话处于未收尾的状态：

def safe_db_operation():
    conn = get_db_connection()
    try:
        with conn.cursor() as cur:
            cur.execute("UPDATE target_table SET ... WHERE ...")
        conn.commit()
    except Exception as e:
        conn.rollback()
        print(f"数据库操作失败: {str(e)}")
        raise
    finally:
        # 短生命周期线程在这里关闭连接；用连接池的话则归还连接
        # conn.close()
        pass

3. 调整连接池配置（如果使用连接池） #

比如用SQLAlchemy的连接池，要确保pool_size和max_overflow的总和能覆盖你的线程数量：

from sqlalchemy import create_engine

# 配置连接池：pool_size是常驻连接数，max_overflow是临时可扩展的连接数
engine = create_engine(
    "postgresql://user:pass@host/test_ebdb",
    pool_size=5,
    max_overflow=10,  # 总可用连接数=15，需大于你的线程总数
    pool_recycle=3600  # 定期回收闲置连接，避免连接失效
)

def get_db_session():
    return engine.connect()

4. 检查线程启停逻辑 #

如果是长驻运行的线程，要确保程序退出时所有线程都能正确关闭数据库连接；如果是定时任务线程，每次任务结束后都要清理连接资源，避免僵尸会话持续积累。

额外排查小技巧 #

• 登录数据库查看当前活跃会话，确认是不是你的线程创建的会话没有释放：
  比如PostgreSQL可以执行SELECT * FROM pg_stat_activity WHERE datname = 'test_ebdb';，看看哪些会话是空闲但未关闭的。
• 检查数据库的max_connections配置，服务器上的数据库默认连接数可能比本地环境小，必要时可以适当调整这个参数。

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