SQLAlchemy 2.0 异步查询必须使用 create_async_engine 配合 asyncpg/aiomysql 等原生异步驱动，SQLite 不支持；需用 AsyncEngine、async_sessionmaker，执行时 await conn.execute() 及 result.scalars().all() 等可等待对象，禁用同步接口如 fetchall()。
SQLAlchemy 2.0 异步查询必须用 create_async_engine
直接拿同步的 create_engine 套 async def 没用，会报 AttributeError: 'Engine' object has no attribute 'connect'。异步支持不是加个 await 就行，底层驱动、连接池、执行器都得换。
关键点：必须用 asyncpg（PostgreSQL）或 aiomysql（MySQL）这类原生异步驱动，且只支持特定数据库；SQLite 不支持异步。
-
create_async_engine返回的是AsyncEngine，不是Engine - URL 中 driver 部分要显式写成
postgresql+asyncpg://...或mysql+aiomysql://...，漏掉+asyncpg会静默退化为同步模式 - 连接必须用
async with engine.connect() as conn:，不能用engine.connect()后手动 close
select() 查询要配合 await conn.execute() 和 scalars()/all()
SQLAlchemy 2.0 的核心查询对象 select() 本身是同步构造的，但执行时必须走异步通道。别在 execute() 后直接调 .fetchall() —— 那是同步方法，会阻塞事件循环。
正确链路是：await conn.execute(stmt) → 调 .scalars() 或 .all()（这两个是 awaitable）→ 再 await 它们：
stmt = select(User.name).where(User.id == 1) result = await conn.execute(stmt) name = await result.scalar_one_or_none() # 注意：scalar_one_or_none 是 awaitable
-
result.scalars().all()返回list，但必须await；await result.scalars().all() - 想取单值优先用
scalar_one_or_none()，它比first()更安全，且原生支持 await - 别用
result.fetchall()，那是同步接口，会抛NotImplementedError
Session 必须用 async_sessionmaker，不能复用 sessionmaker
普通 sessionmaker 创建的是同步 Session，即便传入 AsyncEngine 也会在 commit() 时崩掉，错误信息通常是 RuntimeError: This event loop is already running 或直接卡死。
必须用 async_sessionmaker，并确保所有 session 操作都用 async with：
AsyncSessionLocal = async_sessionmaker(bind=engine, expire_on_commit=False)
async with AsyncSessionLocal() as session:
user = await session.get(User, 1)
await session.commit()
-
expire_on_commit=False很重要，否则commit()后再访问对象属性会触发自动 refresh，而 refresh 是异步操作，容易漏 await -
session.get()可以直接 await，但session.add()不是 awaitable，只是把对象注册进 session；真正持久化靠await session.commit() - 别在
async with外持有session引用，它不支持跨 await 边界使用
常见陷阱：依赖注入、测试、事务嵌套
FastAPI 里用 Depends 注入 AsyncSession 时，很多人直接 yield session，忘了加 await —— yield 本身不触发 await，必须 yield 前 await session.commit()，且整个生成器要用 async def。
测试时若用 pytest-asyncio，注意 event_loop scope 默认是 function 级，而 AsyncEngine 在多个 test 间复用可能引发连接池竞争；建议每个 test 单独建 engine，或显式 await engine.dispose()。
- 嵌套事务（
session.begin_nested()）在异步下可用，但savepoint.rollback()必须await，否则回滚无效 - 日志中间件或 ORM 关系加载（如
user.posts）默认是 lazy load，触发时会隐式发异步查询 —— 必须确保当前上下文有活跃的 async session，否则报greenlet_spawn has not been called - Pydantic v2 的
model_validate不会自动 await 关系字段，需要手动await加载或改用selectinload
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
