Django ORM如何实现元组比较查询适配PostgreSQL多列索引的光标分页

前提说明 #

Django 3.2 及以上版本原生支持该语法，无需额外开发；低于3.2的版本可以用RawSQL表达式兼容。

实现方案 #

1. 原生ORM写法（Django 3.2+ 推荐） #

直接通过F对象组合多字段与游标值做元组比较，生成的SQL会保留元组比较语法，不会被拆分为AND拼接逻辑：

from django.db.models import F

# 示例游标值，为上一页最后一条记录对应排序字段的取值元组
cursor_val = (last_col_a_val, last_col_b_val)

# 构造QuerySet
queryset = queryset.filter(
    (F("col_a"), F("col_b")) > cursor_val
).order_by("col_a", "col_b")

生成的SQL完全符合需求：

WHERE (col_a, col_b) > (%s, %s)
ORDER BY col_a, col_b

2. 低版本Django兼容写法 #

如果使用Django 3.2以下版本，可以通过RawSQL构造通用过滤条件，无需硬编码表名，自动适配多表联查场景下的表前缀：

from django.db.models import F, RawSQL

def cursor_pagination(queryset, sort_fields: list, cursor_vals: tuple):
    """
    通用cursor分页方法
    :param queryset: 传入的任意QuerySet
    :param sort_fields: 排序字段列表，如["col_a", "col_b"]
    :param cursor_vals: 上一页最后一条对应排序字段的取值元组
    """
    field_part = ", ".join([str(F(f)) for f in sort_fields])
    placeholder_part = ", ".join(["%s"] * len(cursor_vals))
    filter_condition = RawSQL(f"({field_part}) > ({placeholder_part})", cursor_vals)
    return queryset.filter(filter_condition).order_by(*sort_fields)

性能说明 #

两种写法生成的SQL均为原生元组比较语法，PostgreSQL可以正常命中(col_a, col_b)多列联合索引，性能和手写原生SQL一致。

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