异步视图需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() 时）。
正确做法是用 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)
注意：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())</p>
别忘了：所有外部 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 或预渲染）——漏掉任意一环，就退回单线程阻塞状态。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
