SQLAlchemy 2.0+中可直接用select()对象作子查询，无需.subquery()；需确保单列、不执行、正确关联外层表，in_()要求类型兼容，exists()需correlate()避免全表扫描。
用 select() 直接构造子查询条件
SQLAlchemy 2.0+ 中，.subquery() 已不是必需步骤。只要子查询本身是 select() 对象（非执行结果），就能直接用于 where() 的比较或存在判断。关键在于：子查询必须返回单列（或明确的标量表达式），且不能提前执行。
常见错误是误用 session.execute(subq).scalars().all() 得到 Python 列表，再塞进 in_() ——这会失去 SQL 层优化，还可能触发 N+1 或类型不匹配。
- 正确写法：把
select(Child.id).where(...)整个对象传给Parent.id.in_(...) - 若需 EXISTS，用
exists(subq)，其中subq是select().where(...) - 注意子查询里别漏
select_from()或明确指定表，否则可能生成笛卡尔积
in_() 和 exists() 的实际写法差异
两者语义不同，生成的 SQL 完全不一样，选错会导致逻辑错误或性能崩塌。比如查“有订单的用户”，用 in_() 要确保子查询只返回 user_id；用 exists() 则更自然，且能关联外层字段。
from sqlalchemy import select, exists✅ in_: 子查询必须单列，且类型与左值兼容
stmt = select(User).where( User.id.in_(select(Order.user_id).where(Order.status == "paid")) )
✅ exists(): 子查询可空，常带 correlated 子句
correlated_subq = select(1).where(Order.user_id == User.id).where(Order.status == "pai
d") stmt = select(User).where(exists(correlated_subq))
如果子查询没加关联条件（如漏掉 Order.user_id == User.id），exists() 会变*表扫描，性能极差。
子查询中引用外层表字段要加 correlate()
当子查询需要访问主查询的列（比如按每个用户的最新订单时间过滤），必须显式声明相关性，否则 SQLAlchemy 默认不关联，生成的 SQL 会报错或逻辑错位。
- 使用
.correlate(User)显式绑定外层表 - 或用
.correlate_except(Order)排除不需要的表（更精细） - SQLAlchemy 2.0+ 推荐优先用
correlate()，比老版本的correlate_existing=True更清晰
不加 correlate() 的典型错误是：生成的 SQL 中子查询里出现未定义别名，PostgreSQL 报 ERROR: missing FROM-clause entry，SQLite 可能静默出错。
避免在子查询里用 limit() 或 offset() 导致兼容性问题
MySQL 5.7、SQLite 等对子查询中含 limit 支持有限，直接写 select(...).limit(1) 可能报语法错误。需要兜底时，得套一层派生表（这时才真得用 .subquery()）。
- 安全做法：先用
select().limit(1).subquery()构造命名子查询，再在外层引用其列 - 如果只是取最大/最小值，优先用聚合函数（
func.max()）替代limit 1排序子查询 - PostgreSQL 支持
LATERAL，但 SQLAlchemy 目前无原生封装，需手写text()或自定义编译规则
真正难处理的是跨数据库的分页子查询——这时候“不使用 .subquery()”的约束反而会成为障碍，得根据目标方言妥协。
