如何用Django ORM基于两列实现LEFT OUTER JOIN查询？

嘿，刚好做过类似的需求，用Django ORM完全可以搞定这种左外连接的查询——既要拿到所有书籍，又要给每本书绑定特定用户的对应笔记，没有笔记的话就显示null。我给你两种实用的方案，看你具体需求选就行：

方案1：用Subquery+annotate直接添加笔记字段 #

这种方法会给每一个Book对象直接加上一个booknote字段，没有笔记时该字段为None，非常直观。

首先要导入需要的工具类：

from django.db.models import Subquery, OuterRef
from django.contrib.auth import get_user_model

然后指定你要查询的目标用户（比如从请求里拿request.user，或者手动指定用户ID）：

User = get_user_model()
# 替换成你要查询的特定用户
target_user = User.objects.get(id=1)  # 或者直接用 request.user

# 构建子查询：找到当前书籍（外层查询的Book主键）对应的该用户的笔记
note_subquery = BookNote.objects.filter(
    book=OuterRef('pk'),  # 关联外层Book的主键
    user=target_user
).values('text')[:1]  # 因为unique_together保证了唯一，所以只取第一条

# 执行查询，给每个Book添加booknote字段
books_with_notes = Book.objects.annotate(
    booknote=Subquery(note_subquery)
).all()

为什么这么写？ #

• OuterRef('pk')是关键，它能引用外层Book查询的主键，让子查询精准关联到对应的书籍。
• 你的BookNote模型已经设置了unique_together = [('book', 'user')]，所以每个用户对同一本书最多只有一条笔记，用[:1]限制子查询返回单条结果，避免报错。
• 最终返回的books_with_notes里，每个Book对象都有booknote属性：有笔记就是对应的文本，没有就是None，完美实现了LEFT OUTER JOIN的效果。

方案2：用Prefetch+prefetch_related获取完整笔记对象 #

如果你需要的不是单纯的笔记文本，而是完整的BookNote对象，可以用这个方法：

from django.db.models import Prefetch

# 定义自定义的Prefetch对象，只拉取目标用户的笔记
notes_prefetch = Prefetch(
    'booknote_set',  # Book和BookNote是一对多关系，反向关联的默认名称是booknote_set
    queryset=BookNote.objects.filter(user=target_user),
    to_attr='user_note'  # 把查询结果存到user_note属性里，避免和默认的booknote_set混淆
)

# 执行预取查询
books_with_notes = Book.objects.prefetch_related(notes_prefetch).all()

之后访问的时候，每个Book对象的user_note是一个列表（因为是一对多关系，但实际只会有0或1个元素）：

for book in books_with_notes:
    # 有笔记就取第一个，没有就是None
    user_note = book.user_note[0] if book.user_note else None

内容的提问来源于stack exchange，提问作者user3599803