SQLAlchemy多表关联查询：移除主表字段且避免报错的方法

问题原因 #

当with_entities中不包含主表sometable1的任何字段时，SQLAlchemy的查询优化逻辑会自动将sometable1从FROM子句中移除，导致后续JOIN操作找不到明确的起始关联表，触发InvalidRequestError。

解决方案 #

方案1：用select_from明确指定主表（最直接）

改用db.session.query()配合select_from强制指定查询的主表，即使不需要返回它的字段：

db.session.query(
    sometable2.user,
    sometable3.user_name,
    sometable4.user
).select_from(sometable1)
.join(
    sometable2,
    sometable2.user_id == sometable1.user_id
).join(
    sometable3,
    sometable3.user_id == sometable2.user_id
).join(
    sometable4,
    sometable4.user_id == sometable3.user_id
).filter(
    sometable1.user_id == 2
).all()

方案2：使用核心select语句构建查询（推荐更清晰的写法）

用SQLAlchemy核心API的select构造查询，逻辑更透明：

from sqlalchemy import select

# 构造查询语句
query_stmt = select(
    sometable2.user,
    sometable3.user_name,
    sometable4.user
).select_from(sometable1)
.join(sometable2, sometable2.user_id == sometable1.user_id)
.join(sometable3, sometable3.user_id == sometable2.user_id)
.join(sometable4, sometable4.user_id == sometable3.user_id)
.where(sometable1.user_id == 2)

# 执行查询
result = db.session.execute(query_stmt).all()

方案3：显式保留主表关联（兼容旧版本）

如果不想改动查询起始方式，也可以在JOIN时通过from_left参数明确指定关联来源（部分版本适用）：

sometable1.query.with_entities(
    sometable2.user,
    sometable3.user_name,
    sometable4.user
).join(
    sometable2,
    sometable2.user_id == sometable1.user_id,
    from_left=True  # 明确从左侧sometable1关联
).join(
    sometable3,
    sometable3.user_id == sometable2.user_id
).join(
    sometable4,
    sometable4.user_id == sometable3.user_id
).filter(
    sometable1.user_id == 2
).all()

内容的提问来源于stack exchange，提问作者VJ P