如何在Django ORM中实现带额外ON条件的左外连接查询？

首先修正模型定义里的笔误：Author类中的model.CharField应该改为models.CharField。

针对你的需求（左外连接时在ON子句添加book.title = author.book_title的额外条件，同时保留ORM的分页功能），可以用以下两种方案实现：

方案一：使用FilteredRelation（Django 2.0+） #

FilteredRelation允许你在关联查询时添加额外的连接条件，直接生成符合要求的LEFT JOIN语句：

from django.db.models import FilteredRelation, Q, F

# 构建查询
books_queryset = Book.objects.annotate(
    # 定义带条件的关联关系
    matched_author=FilteredRelation(
        'author',
        condition=Q(author__book_title=F('title'))
    )
).values('title', 'author_id', 'matched_author__name')

这个查询会生成与你目标SQL结构一致的语句，matched_author__name会返回满足条件的作者名称，无匹配时为NULL，且完全支持PageNumberPagination分页。

方案二：使用Subquery与OuterRef #

通过子查询针对每个Book匹配符合条件的作者，同样能实现需求并保留ORM功能：

from django.db.models import Subquery, OuterRef

# 定义子查询：匹配当前Book对应的作者（满足id和title两个条件）
matched_author_subquery = Author.objects.filter(
    id=OuterRef('author_id'),
    book_title=OuterRef('title')
).values('name')[:1]

# 主查询：为每个Book注解匹配的作者名称
books_queryset = Book.objects.annotate(
    author_name=Subquery(matched_author_subquery)
).values('title', 'author_id', 'author_name')

这种方式兼容性更广，即使在较低版本的Django中也能使用，同时查询性能适配大数据量场景，分页功能不受影响。

内容的提问来源于stack exchange，提问作者Abdul Rahman.