Flask-SQLAlchemy 多表查询应优先用 ORM 而非原生 SQL，需根据关联完整性选择 join() 或 outerjoin()，配合 with_entities() 明确字段、paginate() 数据库级分页，并处理空值与 URL 参数透传。
Flask-SQLAlchemy 中用 join() 和 filter() 组合多表查询
直接写原生 SQL 容易出错且难维护，Flask-SQLAlchemy 的 ORM 方式更稳妥。关键不是“能不能连”，而是“连完怎么取字段、怎么避免 N+1”。比如查订单（Order）及其用户（User）和商品（Product），得明确用 join() 还是 outerjoin()：订单一定有用户，用 join()；但商品可能被下架导致外键失效，这时要用 outerjoin() 避免丢订单。
常见错误是漏掉 query.with_entities() 或直接 .all()，结果拿到一堆对象嵌套，分页时 paginate() 会报 AttributeError: 'list' object has no attribute 'query'。正确做法是先构造查询对象，再调用分页：
orders = Order.query\
.join(User, Order.user_id == User.id)\
.outerjoin(Product, Order.product_id == Product.id)\
.with_entities(Order.id, Order.amount, User.name, Product.title)\
.filter(Order.status == 'paid')
分页必须用 paginate() 而不是切片，且参数顺序别搞反
paginate() 是 Flask-SQLAlchemy 提供的数据库级分页，不是 Python 列表切片。用切片（如 orders[10:20]）会先把全量数据查出来再内存过滤，数据一多就 OOM。而 paginate(page=1, per_page=10) 会生成带 LIMIT 和 OFFSET 的 SQL。
容易踩的坑：page 是从 1 开始的整数，不是 0；per_page 是每页条数，不是偏移量。传 page=0 会返回第一页，传负数可能报错；传字符串（比如从 URL 拿到未校验的 request.args.get('page')）会触发 TypeError。
立即学习“Python免费学习笔记（深入）”；
实操建议：
- 用
int(request.args.get('page', 1))并包try/except处理非法值 - 分页对象返回后，用
pagination.items取当前页数据，pagination.total取总数，pagination.pages取总页数 - 不要对
pagination.items再调.all()—— 它已经是列表了
模板里渲染分页链接时，url_for() 必须透传查询参数
分页链接默认只保留路由路径，但实际页面常带筛选条件（如 ?status=shipped&page=2）。如果只写 {{ url_for('orders', page=2) }}，会丢掉 status，点下一页就回到全部订单。
解决方法是手动合并 request 参数：
@app.route('/orders')
def orders():
query_params = request.args.to_dict()
page = query_params.pop('page', 1)
pagination = Order.query.join(...).filter(...).paginate(
page=int(page), per_page=10
)
return render_template('orders.html', pagination=pagination, query_params=query_params)
模板中拼链接：
<a href="{{ url_for('orders', page=1, **query_params) }}">首页</a>
注意：**query_params 会把所有其他参数（如 status、q）自动加进 URL，不用一个个写死。
关联字段为空时，with_entities() 返回 None 而不是空字符串
用 outerjoin() 后，若关联记录不存在（比如商品被删），Product.title 在 with_entities() 结果里就是 None，不是空字符串或默认值。模板里直接 {{ item.title }} 会显示 “None” 字样，体验很差。
有两个处理方向：
- 在查询中用
func.coalesce(Product.title, '已下架')做数据库层兜底（推荐，减少 Python 层判断） - 在模板里用
{{ item.title or '已下架' }}（简单但逻辑分散） - 绝对不要在 Python 视图里遍历
pagination.items做赋值 —— 这会破坏分页对象的懒加载特性，还可能引发重复查询
复杂点在于：多个外连接 + 多个 coalesce 表达式会让 SQL 变长，调试时要留意日志里的最终 SQL 是否符合预期，特别是 GROUP BY 自动添加问题（如果用了聚合函数却没显式声明 group_by()，SQLAlchemy 可能静默报错或结果错乱）。
