Django中PostgreSQL数据库JSONField使用icontains查询无匹配结果问题

我之前也踩过PostgreSQL JSONField查询的坑，咱们一步步来解决你的问题：

首先排查最明显的错误：遍历对象不对 #

从你打印的favorites内容来看，它是一个完整的字典：

{"Title": ["Fruits"], "Name": ["Banana", "Cherry", "Apple", "Peach"], "Other":["Banana"]}

但你写的for x in favorites是在遍历字典的键（也就是"Title"、"Name"、"Other"），这显然不是你想要的——你应该遍历favorites['Name']这个数组里的水果名称！

修正后的遍历代码应该是：

from functools import reduce
import operator
from django.db.models import Q

# 提取要匹配的水果列表
target_fruits = favorites["Name"]  # 得到 ["Banana", "Cherry", "Apple", "Peach"]
# 生成OR查询条件
query = reduce(operator.or_, (Q(Fruits__Name__icontains=x) for x in target_fruits))

为什么修正遍历后还是可能查不到？ #

__icontains是把整个JSON数组转换成字符串后做模糊匹配，比如你的Name数组存储的字符串形式是"[\"Banana\", \"Cherry\", \"Apple\", \"Peach\"]"，理论上__icontains='Banana'能匹配，但PostgreSQL对JSON的字符串序列化可能有细微差异（比如空格、引号），导致匹配不稳定。

更可靠的是用PostgreSQL原生的JSON数组查询方式：

方法1：精确匹配数组元素（区分大小写） #

用__contains=[x]来检查数组是否包含指定元素，这是Django为PostgreSQL JSONField提供的原生支持：

query = reduce(operator.or_, (Q(Fruits__Name__contains=[x]) for x in target_fruits))
results = MyModel.objects.filter(query)

方法2：不区分大小写的匹配 #

如果需要忽略大小写，可以用PostgreSQL的jsonb_array_elements_text函数展开数组元素，再转小写过滤：

from django.db.models import Func, F, Value

# 先通过子查询提取包含目标水果的ID
filtered_ids = MyModel.objects.annotate(
    # 展开Name数组为单个文本元素
    fruit_name=Func(F('Fruits__Name'), function='jsonb_array_elements_text')
).filter(
    # 不区分大小写匹配任意目标水果
    fruit_name__icontains=Value('|'.join(target_fruits))
).values_list('id', flat=True)

# 再查询这些ID对应的条目
results = MyModel.objects.filter(id__in=filtered_ids)

总结你的原问题根源 #

1. 最初的遍历对象错误，导致你在匹配字典键而非数组元素；
2. 即使遍历正确，__icontains的字符串模糊匹配方式对于JSON数组来说不够可靠，改用PostgreSQL原生的数组查询逻辑才能稳定生效。

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