异步视图需ASGI服务器(如uvicorn)、ORM调用须sync_to_async包装、第三方库须真异步、中间件需实现__acall__、整链路任一环节不同步即失效。

异步视图必须运行在支持 async 的服务器上
Django 4.2 的 async def 视图本身不解决阻塞问题——它只是语法糖;真正起效的前提是整个请求生命周期跑在异步上下文中。如果你用 runserver(默认同步 WSGI 服务),即使写了 async def,Django 也会自动降级为同步执行,且不会报错,但你完全感知不到异步优势。
必须改用 ASGI 服务器,例如 daphne、uvicorn 或 hypercorn。推荐 uvicorn:
pip install uvicorn uvicorn myproject.asgi:application --reload
注意入口是 asgi.py,不是 wsgi.py;若项目没生成 asgi.py,用 django-admin startproject 新建时会自带,老项目需手动补全。
不能在 async 视图里直接调用同步 ORM 方法
Django 的 ORM 默认是同步的,比如 MyModel.objects.get() 或 .save(),在 async def 视图里直接调用会导致事件循环被阻塞,严重拖慢并发能力,甚至引发 RuntimeWarning: coroutine 'get' was never awaited 类错误(尤其在误写成 await MyModel.objects.get() 时)。
立即学习“Python免费学习笔记(深入)”;
正确做法是用 sync_to_async 包装:
from asgiref.sync import sync_to_async <p>async def my_view(request):</p><h1>✅ 正确:显式转为协程</h1><pre class='brush:python;toolbar:false;'>obj = await sync_to_async(MyModel.objects.get)(id=1) # ❌ 错误:直接调用(阻塞) # obj = MyModel.objects.get(id=1) # ❌ 错误:加 await 但没包装(类型不匹配) # obj = await MyModel.objects.get(id=1)</pre>
注意:sync_to_async 本质是把同步调用扔进线程池执行,有开销;高频读写场景建议搭配数据库连接池(如 django-db-geventpool)或改用原生 async 驱动(如 aiopg + 自定义封装)。
第三方库调用必须确认是否真正 async
很多标榜 “async” 的库只是接口返回 Future 或用了 threading,并非基于 async/await。比如旧版 requests 不支持 async,硬套 await requests.get(...) 会报 TypeError: object Response can't be used in 'await' expression。
应替换为真正异步的 HTTP 客户端:
-
aiohttp:需手动管理 session 生命周期,适合复杂控制 -
httpx.AsyncClient:API 兼容requests,推荐新手用
示例:
import httpx
<p>async def api_proxy(request):
async with httpx.AsyncClient() as client:
resp = await client.get("<a href="https://www.php.cn/link/c2148796071914983ed6b6e9dbbff735">https://www.php.cn/link/c2148796071914983ed6b6e9dbbff735</a>")
return JsonResponse(resp.json())别忘了:所有外部 I/O(Redis、Kafka、S3 SDK)都得查清是否提供 async 接口,否则又掉回线程池陷阱。
中间件和装饰器必须兼容 async
Django 4.2 要求中间件也区分同步/异步。如果自定义了中间件(比如日志、权限检查),且没适配,会导致 TypeError: object ... can't be used in 'await' expression 或静默失效。
判断标准很简单:中间件类里是否有 __call__(同步)或 __acall__(异步)方法:
- 同步中间件:只实现
__call__,会被 Django 自动包装,但性能差 - 异步中间件:必须实现
__acall__并返回awaitable,且函数体用async def
常见坑:混用 @login_required 这类传统装饰器——它内部调用的是同步 auth.authenticate,需配合 sync_to_async 重写逻辑,或改用 django.contrib.auth.middleware.AuthenticationMiddleware(它已适配 ASGI)。
异步视图真正的门槛不在写法,而在整条链路的 async 洁癖:ASGI 服务器、ORM 调用、第三方 SDK、中间件、模板渲染(TemplateResponse 是同步的,得用 StreamingHttpResponse 或预渲染)——漏掉任意一环,就退回单线程阻塞状态。


















