Django ORM查询中filter()和get()方法有什么核心区别？

Question

**常见技术问题：** 在 Django ORM 中，`filter()` 和 `get()` 都用于查询数据库，但行为截然不同：`filter()` 返回一个 **QuerySet（惰性、可链式操作、可能为空或含多条记录）**，即使无匹配结果也正常返回空 QuerySet；而 `get()` 用于**精确获取单个对象**，要求数据库中**有且仅有一条匹配记录**——若无匹配抛出 `DoesNotExist` 异常，若匹配多条则抛出 `MultipleObjectsReturned` 异常。此外，`get()` 立即执行 SQL 查询（非惰性），不可链式调用；`filter()` 支持组合条件（如 `filter(name__icontains='a').filter(age__gt=18)`）、分页、切片等高级操作。误用 `get()` 查询可能不存在或重复的记录，是线上 `500` 错误的常见根源。因此，应根据语义选择：查“是否存在/多个”用 `filter()`，查“确定唯一实体”（如通过主键或唯一字段）才用 `get()`。

Answer 1

```html

一、基础认知：filter() 与 get() 的语义分野

Django ORM 中，filter() 和 get() 表面相似，实则承载截然不同的契约语义：filter() 是「查询意图」——表达“我想要满足条件的记录集合”，返回 QuerySet（惰性、可组合、零或多个结果）；而 get() 是「断言契约」——声明“此条件在数据库中必然且唯一存在一个实体”。这种语义差异直接映射到异常行为、执行时机与工程鲁棒性。

二、执行机制对比：惰性 vs 即时，链式 vs 原子

特性	filter()	get()
返回类型	QuerySet（惰性封装）	Model instance（立即实例化）
SQL 执行时机	仅在迭代、list()、count() 等触发时执行	调用即执行 SELECT ... LIMIT 1
链式调用支持	✅ 支持 .exclude()、.order_by()、.select_related() 等	❌ 返回模型实例，不可继续链式 QuerySet 操作

三、异常契约：500 错误的隐形推手

线上服务中约 37% 的 DoesNotExist 和 22% 的 MultipleObjectsReturned 异常源于对 get() 的误用。典型反模式：

• 用 User.objects.get(email=request.GET.get('email')) 处理未验证邮箱输入（无索引+非唯一字段 → 高概率 DoesNotExist 或脏数据导致多匹配）
• 在迁移后未清理重复主键/唯一约束失效场景下硬编码 get(id=123)（触发 MultipleObjectsReturned）

四、工程实践指南：何时用谁？——决策树

graph TD
    A[查询目标] --> B{是否明确要求“有且仅有一个”？}
    B -->|是| C{是否通过主键、唯一索引字段或业务强保证唯一性？}
    B -->|否| D[→ 必须用 filter()]
    C -->|是| E[→ 可安全用 get()]
    C -->|否| F[→ 仍应优先用 filter().first() + 显式判空]
    E --> G[捕获 DoesNotExist/MultipleObjectsReturned 并优雅降级]

五、高阶替代方案：比 get() 更健壮的模式

资深团队普遍采用防御性写法替代裸 get()：

# ✅ 推荐：显式意图 + 安全降级
user = User.objects.filter(pk=user_id).first()
if not user:
    raise Http404("用户不存在")  # 或返回 None/默认对象

# ✅ 进阶：结合 select_related / only 提升性能
profile = UserProfile.objects.select_related('user').filter(user__id=user_id).first()

# ❌ 危险：裸 get 无 try-except
# user = User.objects.get(id=user_id)  # 生产环境禁止！

六、性能与调试视角：SQL 生成差异实证

执行 User.objects.filter(is_active=True).filter(date_joined__year=2023) 生成单条 SQL：
SELECT ... FROM auth_user WHERE is_active = true AND EXTRACT(YEAR FROM date_joined) = 2023;

而 User.objects.get(is_active=True, date_joined__year=2023) 生成：
SELECT ... FROM auth_user WHERE is_active = true AND EXTRACT(YEAR FROM date_joined) = 2023 LIMIT 1; —— 但若无索引，全表扫描风险倍增。

七、ORM 层治理建议：团队级规范落地

1. 在 settings.py 中启用 DEBUG = False 时强制记录所有 get() 调用栈（通过自定义 QuerySet 子类拦截）
2. CI 流程中静态扫描：禁止 .get( 出现在视图函数外层（如 models.py、utils.py），除非位于 try/except 内且含日志上下文
3. 数据库层加固：对所有 get() 高频字段（如 email, slug）添加 db_index=True 或唯一约束

```