Django关联Postgres JSON字段多条件查询耗时过长问题排查

现有代码的核心问题 #

1. 模型定义错误 #

Offer模型未声明attributes字段，但在Meta的indexes中配置了针对attributes的GIN索引，属于明显的语法缺失，实际运行会直接抛出字段不存在的错误，若你本地可正常运行属于粘贴代码时遗漏。你需要先补全字段：

class Offer(models.Model):
    price = models.DecimalField(decimal_places=2, max_digits=8, db_index=True)
    quantity = models.SmallIntegerField()
    model = models.ForeignKey('Model', related_name='offers', on_delete=models.CASCADE)
    # 缺失的字段，补充上
    attributes = models.JSONField(null=True)
    
    class Meta:
        db_table = 'offers'
        indexes = [GinIndex(fields=['attributes'])]

2. 跨关联查询触发多次JOIN导致性能爆炸 #

你连续三次调用filter(offers__attributes__xxx=xxx)，Django ORM规则下每一次跨外键的filter都会生成独立的INNER JOIN，3个筛选条件就会让models表和30万行的offers表做3次关联，直接产生海量笛卡尔积，这是查询耗时20秒的核心原因。

3. prefetch_related使用无效 #

prefetch_related的逻辑是先执行主查询拿到Model的id列表，再单独查询关联的Offer表拉取所有关联数据，完全无法作用于前面的filter筛选条件，而且会额外拉取所有不符合条件的Offer数据，白白浪费内存和IO。

4. GIN索引未生效 #

默认的GinIndex针对JSONField仅支持__contains、__has_key这类操作符，你使用的__width/__height这类键值点查语法，Django会生成attributes->>'width' = '255'的SQL，无法命中GIN索引，相当于全表扫描30万行Offer数据。

优化方案 #

1. 合并关联筛选条件，避免多次JOIN #

将三个Offer属性的筛选条件合并为单个__contains查询，只会生成一次JOIN，且可以命中GIN索引：

from django.db.models import Prefetch

# 提前过滤符合条件的Offer
valid_offer_qs = Offer.objects.filter(
    attributes__contains={
        "width": "255",
        "height": "55",
        "diameter": "16"
    }
)

result = (
    Model.objects
    # 仅拉取符合条件的Offer，避免拉取所有关联数据
    .prefetch_related(Prefetch('offers', queryset=valid_offer_qs))
    # 合并Model的属性筛选
    .filter(
        attributes__param1='value1',
        attributes__param2=False,
        # 合并Offer的筛选条件，仅触发一次JOIN
        offers__in=valid_offer_qs
    )
    # 避免多次JOIN产生重复的Model结果
    .distinct()
)

2. 优化GIN索引配置 #

如果你常用__contains查询JSON字段，可以将索引改为jsonb_path_ops类型，查询效率比默认GIN索引高3倍左右：

indexes = [
    GinIndex(
        fields=['attributes'],
        name='offers_attrs_path_idx',
        opclasses=['jsonb_path_ops']
    )
]

3. 固定键查询优化 #

如果width/height/diameter是高频查询字段，建议直接给这些单独的键创建B树索引，查询性能远高于JSON通用索引：

indexes = [
    models.Index(
        models.F("attributes__width"),
        name="offer_attr_width_idx"
    ),
    models.Index(
        models.F("attributes__height"),
        name="offer_attr_height_idx"
    ),
    models.Index(
        models.F("attributes__diameter"),
        name="offer_attr_diameter_idx"
    )
]

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