Django 查询数据库 N+1 问题怎么用 select_related 优化

对于 Django 中因外键或一对一关系引发的 N+1 查询问题，最直接的优化方式是在查询主模型时使用 select_related 方法，它通过 SQL JOIN 一次性获取关联数据，适用于 ForeignKey 和 OneToOneField 场景。

先说结论：select_related 是解决外键关联查询性能问题的首选方案，但必须确认关联字段类型正确且确实存在重复查询。

先定位：通过日志或调试工具确认是否存在循环查询数据库的现象。
先做：在 QuerySet 上链式调用 select_related 指定关联字段。
再验证：对比优化前后的 SQL 查询次数，确保 JOIN 生效且无副作用。

模型定义与问题复现

为了直观展示优化效果，首先定义包含外键关系的模型。假设有一个 Blog 和 Entry 模型：

Django 查询数据库 N+1 问题怎么用 select_related 优化

from django.db import models

class Blog(models.Model):
    name = models.CharField(max_length=100)

class Entry(models.Model):
    blog = models.ForeignKey(Blog, on_delete=models.CASCADE)
    headline = models.CharField(max_length=100)

在未优化的情况下，遍历 Entry 并访问关联的 Blog 对象会触发 N+1 查询：

entries = Entry.objects.all()
for entry in entries:
    print(entry.blog.name)  # 每次循环触发一次查询

使用 select_related 优化

在 QuerySet 初始化时链式调用 select_related 并指定外键字段名：

entries = Entry.objects.select_related('blog').all()
for entry in entries:
    print(entry.blog.name)  # 数据已在初始查询中获取，不再触发新查询

配置 SQL 日志验证

在 settings.py 中配置 LOGGING 字典，将 django.db.backends 级别设为 DEBUG，以便在控制台观察查询次数：

LOGGING = {
    'version': 1,
    'disable_existing_loggers': False,
    'handlers': {
        'console': {
            'class': 'logging.StreamHandler',
        },
    },
    'loggers': {
        'django.db.backends': {
            'handlers': ['console'],
            'level': 'DEBUG',
        },
    },
}

配置生效后，优化前遍历 10 条数据可能看到 11 条 SQL 语句（1 次查主表 +10 次查关联表）。优化后，应该只看到 1 条带有 JOIN 子句的 SQL 语句。也可以使用 Django Debug Toolbar 插件直接显示当前请求的查询总数。

常见坑与注意事项

误用于多对多关系：ManyToManyField 或反向 ForeignKey 关系不能使用 select_related，否则不会生效，这类情况应使用 prefetch_related。
过度关联：如果关联的表数据量极大或字段过多，JOIN 可能导致单次查询变慢，需权衡查询次数与单次查询成本。
字段拼写错误：select_related 中的字段名必须是模型中定义的外键字段名，拼写错误会导致 AttributeError 或无效优化。

参考来源

Django Documentation, "QuerySet API reference", https://docs.djangoproject.com/en/stable/ref/models/querysets/#select-related
Django Documentation, "Optimizing database queries", https://docs.djangoproject.com/en/stable/topics/db/optimization/