Django 接口响应慢如何优化数据库查询次数？

Django 接口响应慢通常由 N+1 查询问题导致，最直接的优化方向是使用 ORM 的 select_related 和 prefetch_related 方法减少数据库交互次数。适用场景为列表页或嵌套数据序列化，风险边界在于过度预取可能导致单次查询体积过大。

先说结论：解决 Django 数据库查询次数过多的核心是消除 N+1 查询，通过预加载关联对象将多次查询合并为少量查询。

先定位：使用 Django Debug Toolbar 或开启 SQL 日志确认实际查询次数。
先做：针对 ForeignKey 使用 select_related，针对 ManyToMany 使用 prefetch_related。
再验证：对比优化前后的 SQL 查询总数和接口响应时间。

快速处理思路

Django 优化查询次数不需要系统命令，而是通过调整 ORM 查询代码实现。以下是核心代码调整模式：

# 优化前：循环中触发查询
for obj in Model.objects.all():
    print(obj.related_field.name)

# 优化后：使用 select_related 预加载 ForeignKey
for obj in Model.objects.select_related('related_field').all():
    print(obj.related_field.name)

# 优化后：使用 prefetch_related 预加载 ManyToMany
for obj in Model.objects.prefetch_related('many_field').all():
    for item in obj.many_field.all():
        print(item.name)

为什么会这样

数据库查询次数过多主要是因为代码在循环中隐式触发了额外查询，即 N+1 查询问题。Django ORM 默认懒加载关联对象，访问关联字段时会单独发起一次 SQL 查询，如果外层循环有 N 条数据，就会额外产生 N 次查询。减少查询次数能降低网络往返开销和数据库连接等待时间，从而提升接口响应速度。

分步处理

第一步：开启查询监控。在开发环境安装 django-debug-toolbar，或在 settings.py 中设置 LOGGING 配置捕获 django.db.backends 的 SQL 日志。

第二步：识别高频查询。观察接口请求期间的 SQL 面板，查找重复出现的相似 SELECT 语句，确认是否存在循环查询。

第三步：应用预加载方法。在视图层的 QuerySet 上链式调用 select_related 处理单值关联，调用 prefetch_related 处理多值关联。

第四步：检查序列化器。如果使用 Django REST Framework，检查 Serializer 中的 Source 字段是否触发了额外查询，必要时在视图层统一预取。

怎么验证是否生效

查看 Django Debug Toolbar 的 SQL 面板，确认相同接口请求下的查询总数（Queries）明显下降。观察日志中类似 SELECT ... FROM table WHERE id = ... 的重复语句是否消失。接口响应时间通常随查询次数减少而降低，但需关注单次查询耗时是否因 JOIN 过大而增加。

常见坑

过度使用 select_related 会导致 SQL 语句包含大量 JOIN，若关联表数据量大，单次查询耗时可能反而增加。prefetch_related 会在内存中构建映射，若预取数据量过大可能消耗大量内存。在序列化嵌套过深时，需分层预取，避免一次性加载无关数据。

常见问题

select_related 和 prefetch_related 有什么区别？

select_related 通过 SQL JOIN 实现，适合 ForeignKey 和 OneToOne 字段；prefetch_related 通过 Python 在内存中关联，适合 ManyToMany 和反向 ForeignKey 字段。

生产环境如何监控查询次数？

生产环境不建议开启 django-debug-toolbar，可使用 django-silk 或自定义中间件记录 connection.queries 长度，配合 APM 工具如 Sentry 进行监控。

参考来源

Django Documentation, Database optimization, https://docs.djangoproject.com/en/stable/topics/db/optimization/
Django Debug Toolbar Documentation, https://django-debug-toolbar.readthedocs.io/