Django ORM同步方法不能直接在async视图中使用，因其会阻塞事件循环线程并触发SynchronousOnlyOperation异常；必须用sync_to_async包装且显式await调用，thread_sensitive=True为必需参数以保障数据库连接安全。
必须用 sync_to_async 包装，且显式 await 调用；直接调用会触发 SynchronousOnlyOperation 异常并卡死事件循环。
为什么 Django ORM 同步方法不能直接在 async 视图里用
Django 从 3.1 开始对异步上下文做硬性拦截：一旦检测到 User.objects.filter()、.first()、.count() 等同步 ORM 方法在 async def 中执行，立刻抛出 SynchronousOnlyOperation。这不是 bug，是保护机制——这些方法会阻塞当前线程，而 asyncio 事件循环只跑在一个线程里，一卡全卡。
常见翻车现场：
- 写成
user = sync_to_async(User.objects.get)(id=1)—— 没await，返回的是Awaitable对象，后续逻辑拿不到数据 - 写成
user = await sync_to_async(User.objects.get(id=1))——.get(id=1)带括号，同步代码当场执行，异常照抛 - 用
list(queryset)或queryset[0]强制求值，同样属于同步操作，必须包
sync_to_async 的参数怎么选：thread_sensitive=True 还是 False
thread_sensitive 控制线程绑定策略，默认为 True，适用于绝大多数 Django 场景（ORM、缓存、文件读写）。
立即学习“Python免费学习笔记（深入）”；
关键区别：
-
thread_sensitive=True：包装后的函数会在**同一个线程池线程**中执行多次调用，确保线程局部变量（如数据库连接、Django 请求上下文）不丢失。Django ORM 必须用这个 -
thread_sensitive=False：任务可被调度到任意空闲线程，适合纯计算型操作（如json.loads、图像缩放），但 ORM 绝对不能设为False，否则可能报DatabaseWrapper objects created in a thread can only be used in that same thread
示例：
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
下载
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
from asgiref.sync import sync_to_async <h1>✅ 正确：ORM 查询必须 thread_sensitive=True（默认就是）</h1><p>get_count = sync_to_async(lambda: User.objects.count())</p><h1>❌ 危险：thread_sensitive=False + ORM → 线程错乱</h1><p>bad_get = sync_to_async(lambda: User.objects.count(), thread_sensitive=False)</p>
传参和链式调用的写法陷阱
sync_to_async 包裹的是「可调用对象」，不是调用结果。所以 .filter() 后不能加 ()，.first 后也不能加 ()，否则就变成同步执行了。
正确模式：
- 简单无参：
await sync_to_async(User.objects.count)() - 带参数：
await sync_to_async(User.objects.get)(id=1)（参数传给外层括号） - 链式：
await sync_to_async(User.objects.filter(status="active").first)()（注意.first不带括号） - 避免
.all()后接list()：改用await sync_to_async(list)(queryset)，否则list(queryset)本身就会触发同步求值
比 sync_to_async 更轻量的替代？别乱换
有人想用 loop.run_in_executor 或 asyncio.to_thread 替代 sync_to_async，这在技术上可行，但不推荐用于 Django ORM。
原因很实际：
-
sync_to_async内部已深度集成 Django 的数据库连接管理，能自动复用请求线程的连接池，避免新建连接开销 -
run_in_executor是通用线程池，无法感知 Django 上下文，容易导致连接泄漏或跨线程使用同一连接 -
asyncio.to_thread（Python 3.9+）底层也是run_in_executor，只是语法糖，同样绕不开上下文问题
结论：ORM 就老实用 sync_to_async；纯计算或第三方库（如 requests.get）才考虑 to_thread。
