N+1查询：数据库性能的隐形杀手与终极拯救指南-CSDN博客

本文链接：https://blog.csdn.net/qq_42210428/article/details/147725021

title: N+1查询：数据库性能的隐形杀手与终极拯救指南
date: 2025/05/06 00:16:30
updated: 2025/05/06 00:16:30
author: cmdragon

excerpt:
N+1查询问题是ORM中常见的性能陷阱，表现为在查询主对象时，对每个关联对象进行单独查询，导致查询次数过多。以博客系统为例，查询10位作者及其文章会产生11次查询。通过Tortoise-ORM的prefetch_related方法，可以将查询优化为2次，显著提升性能。优化后的实现方案包括使用SQL JOIN语句加载关联数据，并结合FastAPI进行实践。进阶优化技巧包括多层预加载、选择性字段加载和分页查询结合。常见报错涉及模型注册、连接关闭和字段匹配问题，需针对性解决。

categories:

后端开发
FastAPI

tags:

N+1查询问题
Tortoise-ORM
异步预加载
FastAPI
数据库优化
SQL查询
性能分析

扫描二维码)
关注或者微信搜一搜：编程智域前端至全栈交流与成长

探索数千个预构建的 AI 应用，开启你的下一个伟大创意：https://tools.cmdragon.cn/

第一章：理解N+1查询问题本质

1.1 什么是N+1查询问题？

N+1查询是ORM使用过程中常见的性能陷阱。假设我们有一个博客系统，当查询作者列表时，如果每个作者关联了多篇文章，常规查询会先获取N个作者（1次查询），然后为每个作者单独执行文章查询（N次查询），总共产生N+1次数据库查询。

示例场景：

数据库包含10位作者
每位作者有5篇文章
常规查询会产生1（作者）+10（文章）=11次查询

1.2 问题复现与性能影响

使用Tortoise-ORM创建数据模型：

# models.py
from tortoise.models import Model
from tortoise import fields


class Author(Model):
    id = fields.IntField(pk=True)
    name = fields.CharField(max_length=50)


class Article(Model):
    id = fields.IntField(pk=True)
    title = fields.CharField(max_length=100)
    content = fields.TextField()
    author = fields.ForeignKeyField('models.Author', related_name='articles')

问题查询代码示例：

async def get_authors_with_articles():
    authors = await Author.all()
    result =