Django 中 .all() 方法的行为解析:何时查库、何时用缓存?

浅辰大大_3504

浅辰大大_3504

2026-09-22

815人浏览

原创

Django 中 .all() 方法的行为解析:何时查库、何时用缓存?

.all() 对 QuerySet 会创建新克隆(不共享缓存),触发重复查询;但对 RelatedManager(如 obj.relationship.all())则直接返回已预取的缓存结果,不查库——关键区别在于调用对象是 QuerySet 还是 Manager。

.all() 对 queryset 会创建新克隆(不共享缓存),触发重复查询;但对 relatedmanager(如 `obj.relationship.all()`)则直接返回已预取的缓存结果,不查库——关键区别在于调用对象是 queryset 还是 manager。

在 Django 开发中,.all() 看似简单,却常引发性能困惑:它到底查数据库,还是复用缓存?答案取决于被调用的对象类型——这是理解其行为的核心。

✅ 情况一:.all() 调用于已存在的 QuerySet(会克隆 + 可能重复查询)

qs = Restaurant.objects.filter(active=True)
list(qs)        # 第一次求值 → 执行 SQL 查询,并缓存结果到 qs 的内部 cache
list(qs.all())  # qs.all() 返回一个全新克隆的 QuerySet(cache 为空)
                # → 再次执行相同 SQL,产生冗余查询!

原因在于:.all()QuerySet 类中本质是 self._clone()(Django 源码证实)。克隆后的 QuerySet 拥有独立的 _result_cache,与原 QuerySet 互不影响。因此,即使原 QuerySet 已缓存结果,.all() 克隆体仍会重新触发数据库查询(除非你显式复用或提前缓存)。

⚠️ 注意:文档中“you can get updated results by calling .all()”指的是主动放弃旧缓存、强制刷新的语义,而非“智能复用”。它是一种“重置式重查”,不是“惰性复用”。

✅ 情况二:.all() 调用于 RelatedManager(如 obj.foreign_key_set.all()obj.many_to_many_field.all())→ 不查库,纯用缓存

restaurants = Restaurant.objects.prefetch_related('pizzas').all()
restaurant = restaurants[0]

# ✅ 安全:pizzas 是 PrefetchManager 实例,.all() 直接返回已 prefetch 的内存列表
pizzas = restaurant.pizzas.all()  # 零查询!等价于 list(restaurant.pizzas.all())

此时 restaurant.pizzas 并非 QuerySet,而是一个 RelatedManager(具体为 PrefetchRelatedManager)。它的 .all() 方法不走 QuerySet 克隆逻辑,而是直接委托给 self.get_queryset() —— 而该方法在预取后会返回一个已填充 _result_cache 的 QuerySet(源自 prefetch_related 的预加载结果)。

Django
Django

避免常见的 Django 错误——QuerySet 评估、N+1 查询、迁移冲突和 ORM 陷阱。

下载

源码佐证(Django RelatedManager.all):

def all(self):
    return self.get_queryset()  # ← 不克隆!直接返回预取好的 QuerySet(含缓存)

? 关键总结:一句话区分

调用主体 .all() 行为 是否查库 原因说明
QuerySet 实例 创建新克隆,_result_cache 为空 ✅ 是 克隆不继承缓存,首次求值必查
RelatedManager 实例(如 obj.rel_set.all() 返回 get_queryset(),复用预取缓存 ❌ 否 Manager 层绕过克隆,直取结果

? 最佳实践建议

  • 避免无谓 .all():对已赋值的 QuerySet,优先直接使用(如 qs),而非 qs.all()
  • 预取后放心遍历prefetch_related / select_related 后,关系属性的 .all() 是安全的;
  • 需刷新数据?显式处理:若需最新数据,应重新构造 QuerySet(如 Model.objects.filter(...)),而非依赖 .all() 的“重查”语义;
  • 调试技巧:开启 django.db.connection.queries 或使用 django-debug-toolbar,实时观察实际 SQL 发送次数。

理解这一差异,是写出高效、可预测 Django ORM 代码的关键一步。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

django

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

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

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

2023.07.20

1551

4

python能做什么
python能做什么

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

2023.07.25

3664

7

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

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

2023.07.31

1569

3

python教程
python教程

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

2023.08.03

20977

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

1083

5

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

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

2023.08.10

576

4

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

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

2023.08.11

2043

5

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Django 6.1 官方文档
Django 6.1 官方文档

共0课时 | 0人学习

Django 教程
Django 教程

共28课时 | 9.6万人学习

Django DRF 源码解析
Django DRF 源码解析

共21课时 | 2万人学习