如何在Python Flask中利用SQLAlchemy的Eager Loading减少查询?

云萱君_1810

云萱君_1810

2026-07-21

323人浏览

原创

n+1查询在flask-sqlalchemy中易发生,因relationship默认lazy='select',访问user.posts等关联属性时逐个触发sql;应优先用selectinload(一对多安全)或joinedload(一对一/小数据),配合sql日志与explain分析优化。

如何在python flask中利用sqlalchemy的eager loading减少查询?

为什么N+1查询在Flask-SQLAlchemy里特别容易发生

你在模板里写 {{ user.posts[0].title }},或者视图中循环 for post in user.posts:,而 user 是通过 db.session.query(User).get(1) 拿到的——这时候 SQLAlchemy 默认不会预加载 posts 关系,而是每访问一次 post 就发一条新查询。1个用户 + 10篇帖子 = 11次SQL,不是1次。

这种行为在开发模式下可能不明显,但上线后QPS稍高就会拖垮数据库连接池,且慢查询日志里全是重复的 SELECT * FROM post WHERE user_id = ?

joinedload() 做一对多关系的单次JOIN查询

适用于关联数据量不大、字段不多、且需要全部读取的场景(比如用户+头像+最近5条动态)。它把主表和关联表用 LEFT JOIN 一次性查出,避免后续触发懒加载。

Shadows Python Sensei
Shadows Python Sensei

Python 最佳实践助手——代码规范、设计模式、性能优化、测试与类型注解。适用于编写或审查 Python 代码。

下载
  • 必须显式导入:from sqlalchemy.orm import joinedload
  • 不能和 .filter() 在同一层混用 joinedload 的条件(比如想只查已发布的帖子?joinedload 不支持 where 过滤,得换 selectinload 或子查询)
  • joinedload 可能导致重复行(尤其一对多时),query.all() 返回的对象数仍以主表为准,但底层SQL结果集会膨胀——内存占用略高,但网络IO和DB解析开销大幅下降
  • 示例:db.session.query(User).options(joinedload(User.posts)).filter(User.active == True).all()

selectinload() 避免JOIN膨胀,适合大数据量关系

当一个用户有几百条帖子,或你要查几十个用户时,joinedload 产生的笛卡尔积会让结果集爆炸,甚至OOM。selectinload 改用“主键IN”方式:先查出所有 User.id,再用一条 SELECT ... WHERE user_id IN (1,2,3...) 批量拉取关联数据,两次查询但无重复行。

  • 不需要额外导入,和 joinedload 用法一致:options(selectinload(User.posts))
  • 对 PostgreSQL/MySQL 8.0+ 效果稳定;SQLite 下 IN 列表过长可能报错,需注意 max_in_list_size 配置
  • 无法跨多层嵌套做深度预加载(比如 User → posts → comments),第二层得单独加 selectinload
  • joinedload 多一次网络往返,但数据干净、内存友好,多数生产场景更推荐

别忽略 lazy 参数和模型定义里的默认行为

很多问题其实根子在模型定义上。比如你写了 posts = relationship("Post", back_populates="user"),没设 lazy,那默认就是 'select'(即懒加载),一碰就查。这不是 bug,是设计使然。

  • 想全局禁用懒加载?不行。但可以在定义时显式设 lazy='joined'lazy='selectin' ——不过不推荐,会失去灵活性
  • 真正该做的是:在绝大多数 API 或页面渲染路径中,**主动用 options() 覆盖默认行为**,而不是依赖模型上的 lazy
  • 调试时打开 SQL 日志:app.config['SQLALCHEMY_ECHO'] = True,眼见为实。看到连续出现相同 pattern 的 SELECT,基本就是 N+1 了
  • 注意:subqueryloadimmediateload 极少用,前者生成子查询易失控,后者强制立即加载但破坏延迟特性,基本可忽略

预加载不是开关,是权衡:JOIN vs 多查、内存 vs 网络、简单性 vs 精确控制。线上跑着的 joinedload 如果突然变慢,先看关联表数据量是否涨了十倍——这时候换 selectinload 往往比调优SQL更有效。

Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

2023.07.20

1551

4

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

2023.07.25

3644

7

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.31

1569

3

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

2023.08.03

20857

23

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

2587

5

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

2647

5

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

1063

5

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.10

576

4

python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2043

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程