如何在Flask SQLAlchemy中实现Left Join（左连接）？

我明白你遇到的问题了——你想用Flask-SQLAlchemy实现左连接，但试了两种写法都报错，提示BaseQuery没有leftjoin属性。其实问题出在方法名称上，Flask-SQLAlchemy里对应的左连接方法是outerjoin，而不是leftjoin，这是因为它直接沿用了SQLAlchemy核心库的命名（SQLAlchemy中左外连接用outerjoin，leftjoin是它的别名，但在Flask-SQLAlchemy的BaseQuery中并没有暴露这个别名）。

下面给你几种正确的实现方式：

方法1：使用模型的Query对象（推荐） #

直接在CarLogs.query后调用outerjoin方法，传入关联模型和连接条件即可：

# 获取所有CarLogs记录，即使没有对应Vehicle也会返回
results = CarLogs.query.outerjoin(Vehicle, CarLogs.vehicle_id == Vehicle.id).all()

如果你的模型之间已经定义了关联关系（比如在CarLogs模型中添加了：vehicle = db.relationship('Vehicle', backref='car_logs')），还可以省略连接条件，写法更简洁：

results = CarLogs.query.outerjoin(Vehicle).all()
# 或者明确指定关联属性
results = CarLogs.query.outerjoin(CarLogs.vehicle).all()

方法2：使用db.session.query #

如果你需要同时查询两个模型的所有字段，用db.session.query的写法如下（同样替换leftjoin为outerjoin，注意参数顺序）：

results = db.session.query(CarLogs, Vehicle).outerjoin(Vehicle, CarLogs.vehicle_id == Vehicle.id).all()

验证效果 #

以上写法都会生成你需要的SQL语句（类似）：

SELECT carlogs.*, vehicles.* FROM carlogs LEFT OUTER JOIN vehicles ON vehicles.id = carlogs.vehicle_id

完全符合你想要的左连接逻辑——返回所有CARLOGS的记录，匹配到vehicles的会带上对应数据，没匹配到的Vehicle相关字段会是None。

内容的提问来源于stack exchange，提问作者Ahmad Anis