Django ORM多线程报SSL连接关闭或已关闭错误，源于线程绑定连接被复用：主线程关闭后子线程仍读写，或并发close导致提前释放；正确做法是子线程启动时调用connection.close()，再执行查询以触发新连接。
为什么Django ORM在多线程里会报 OperationalError: SSL connection has been closed 或 connection already closed
Django 默认的数据库连接是**线程绑定**的，即每个线程首次访问数据库时创建独立连接，该连接生命周期与线程绑定。但若手动在子线程中复用主线程的 connection 对象（比如把 django.db.connection 传入线程函数），就会触发连接状态错乱：主线程可能已关闭连接，而子线程还在读写；或多个线程并发调用 connection.close() 导致连接提前释放。
常见诱因包括：
- 使用
threading.Thread时直接共享全局connection或models.Manager - 在 Celery 任务中未正确配置
CONN_MAX_AGE=0，且任务运行在线程池中 - 自定义线程池中重复调用
Model.objects.all()而未触发连接重建逻辑
如何让每个线程获得独立、干净的数据库连接
Django 提供了 django.db.connections 接口，但关键不在“获取”，而在“重置”。线程启动后第一件事不是查数据，而是**强制重置当前线程的连接状态**：
- 调用
from django.db import reset_queries, connection后，执行connection.close()—— 这会清理旧连接句柄 - 下一次 ORM 查询（如
User.objects.first()）会自动触发新连接建立，且归属当前线程 - 如果用的是 PostgreSQL 或 MySQL，确保
CONN_MAX_AGE设为0（禁用连接复用），避免连接被意外复用到其他线程
示例：
立即学习“Python免费学习笔记（深入）”；
import threading from django.db import connection, reset_queries <p>def thread_worker():</p><h1>关键：先关掉可能继承来的 connection</h1><pre class="brush:php;toolbar:false;">connection.close() # 此时第一次查询会新建连接 user = User.objects.filter(id=1).first() print(user)
threading.Thread(target=thread_worker).start()
使用 database routers 或 using() 时的线程安全陷阱
当项目用了多数据库（如读写分离），并依赖 db_router 或显式调用 Model.objects.using('slave')，要注意：using() 返回的 QuerySet 不会自动绑定线程连接，它只是标记目标 alias；真正执行（list()、first() 等）时才从 connections['slave'] 拿连接 —— 而这个连接对象仍受线程绑定规则约束。
- 错误做法：主线程创建
qs = User.objects.using('slave')，再传给子线程执行qs.first()—— 子线程可能复用主线程已关闭的connections['slave'] - 正确做法：子线程内完整构造并执行 QuerySet，即
User.objects.using('slave').first()写在线程函数内部 - 若必须传递 QuerySet，需配合
connection.close()+ 显式connections['slave'].close()在子线程开头执行
Celery + Django 多线程任务的典型修复配置
Celery worker 默认用多进程（prefork），但若改用 pool=threads（例如 celery -P threads），就完全落入线程安全范畴。此时仅靠 CONN_MAX_AGE=0 不够，还需：
- 在
CELERY_TASK_TRACK_STARTED=True下，确保每个 task 函数开头调用from django.db import connection; connection.close() - 禁用
CONN_HEALTH_CHECKS（Django 4.2+），避免后台健康检查干扰线程连接状态 - 避免在
AppConfig.ready()中预热数据库连接（如执行User.objects.count()），这类代码会在主进程运行，连接不会复制到子线程
最稳妥的方式仍是：所有数据库操作封装在 task 函数体内，不跨线程共享 ORM 对象或连接实例。
线程和连接的边界其实很薄——你以为传的是 QuerySet，实际传的是对连接的隐式依赖；你以为 close 了一次，其实只关掉了当前线程视角下的句柄。真正的安全，是让每次查询都从“连接池零状态”开始，而不是试图复用什么。
