django 5.0 的 aget()、afilter() 等异步 orm 方法仅在使用 asyncpg（postgresql）或 aiomysql/asyncmy（mysql）等真正异步驱动时才生效；混用同步驱动（如 psycopg2、sqlite）或同步方法会导致静默降级为同步执行。
确认数据库驱动是否支持异步
Django 5.0 的 aget()、afilter() 等方法只在底层驱动真正异步时才有效。PostgreSQL 必须用 asyncpg，MySQL 必须用 aiomysql 或 asyncmy；SQLite 和默认的 psycopg2 不行。
常见错误现象：RuntimeError: This method must be run in async mode 或查询仍阻塞事件循环——多半是驱动没换。
- PostgreSQL：卸载
psycopg2，安装asyncpg，并在DATABASES中指定'ENGINE': 'django.db.backends.postgresql_async' - MySQL：安装
asyncmy（推荐），设'ENGINE': 'django.db.backends.mysql_async' - 检查是否生效：启动 ASGI 服务后，日志里应出现
AsyncDatabaseWrapper初始化记录
避免混用同步/异步 ORM 方法
一个 get() 调用就足以让整个请求静默降级为同步模式，且不报错——这是最隐蔽的性能陷阱。
正确写法只用带 a 前缀的方法：
# ✅ 正确：全链路异步
user = await User.objects.aget(id=1)
posts = await Post.objects.aprefetch_related('author').afilter(status='published')
<h1>❌ 错误：混用触发降级</h1><p>user = User.objects.get(id=1) # 同步调用 → 整个视图变同步
posts = await Post.objects.afilter(...) # 这行仍执行，但已不在协程上下文中
</p>
-
afirst()、acount()、aexists()都可用，但all()本身不 await，得写await MyModel.objects.all() -
async for可用于流式处理大结果集，避免一次性加载：async for obj in MyModel.objects.afilter(...):
配置连接池与长连接
异步数据库性能瓶颈常不在 ORM 层，而在连接建立开销。Django 5.0 支持原生连接池参数，但需驱动配合。
以 PostgreSQL + asyncpg 为例，在 DATABASES 中加：
'OPTIONS': {
'min_size': 5,
'max_size': 20,
'command_timeout': 60,
},
'CONN_MAX_AGE': 600,
-
CONN_MAX_AGE控制连接复用时间，设为非零值才能发挥连接池作用 -
min_size/max_size是asyncpg特有参数，aiomysql用max_connections - 别漏掉
ASGI_APPLICATION = "myproject.asgi.application"，WSGI 下连接池无效
中间件和缓存必须异步就绪
哪怕数据库和视图都异步了，一个同步中间件（比如旧版 SessionMiddleware 或自定义日志中间件）也会强制整条链路回退到线程池模式。
检查点：
- 运行
./manage.py showmigrations确认你用的是 Django 5.0 自带的中间件（如SecurityMiddleware已支持 async） - 自定义中间件必须实现
async def __call__(self, request)，且内部所有操作（如cache.get()）都要用await cache.aget() -
cache后端必须启用异步支持：Redis 用django.core.cache.backends.redis.RedisCache（5.0+ 内置），不能用LocMemCache（无异步接口）
最容易被忽略的是模板渲染——render() 是同步的，要异步就得显式 await render_to_string()，且模板里不能含同步自定义标签。
