如何判断Django模型列表字段字符串含子串及编写Postgres ArrayField过滤查询

这个问题我之前也踩过坑——Django默认的__icontains对ArrayField的逻辑和我们想的不一样：它是检查数组是否包含某个完整的匹配字符串，而不是数组里的元素是否包含子串。所以你直接用MyObject.objects.filter(some_arrayfield__icontains="match")找不到["item1", "item2", "item3match"]这种实例，因为它在找完全等于"match"的元素，而不是包含"match"的元素。

下面给你两种实用的解决方案：

方法一：用Django Postgres扩展的__any查找器（推荐） #

Django为Postgres的ArrayField提供了__any查找器，它能把后续的过滤规则应用到数组的每一个元素上。结合__icontains就能实现“数组中任意元素包含指定子串”的需求，写法非常简洁：

from myapp.models import MyObject

# 不区分大小写的子串匹配
matches = MyObject.objects.filter(some_arrayfield__any__icontains="match")

# 如果需要区分大小写，换成__contains
case_sensitive_matches = MyObject.objects.filter(some_arrayfield__any__contains="Match")

这个查询会直接命中你说的那个some_arrayfield为["item1", "item2", "item3match"]的实例，因为item3match包含"match"子串，__any会遍历数组所有元素进行检查。

方法二：原生SQL查询（适合复杂场景） #

如果你的过滤逻辑更复杂，或者想直接写Postgres原生语法，可以用RawSQL来实现：

from myapp.models import MyObject

matches = MyObject.objects.raw(
    "SELECT * FROM myapp_myobject WHERE EXISTS (SELECT 1 FROM unnest(some_arrayfield) AS elem WHERE elem ILIKE %s)",
    ('%match%',)
)

这里用unnest把数组展开成单行元素，再用ILIKE（Postgres的不区分大小写模糊匹配）检查元素是否包含目标子串，最后用EXISTS判断是否存在符合条件的元素。

补充小提示 #

• 确保你已经在INSTALLED_APPS里添加了django.contrib.postgres，毕竟ArrayField本身就依赖这个扩展。
• 如果你用的是Django 3.0及以上版本，__any查找器是完全支持的；更早的版本可能需要用Func构造自定义表达式，但这种写法不如__any直观，所以优先升级版本或者用方法一。

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