Django中ArrayField精确匹配元素的查询问题

这是个很常见的坑——你用__icontains来查询数组元素，结果因为它是字符串子串匹配而非数组元素的精确匹配，导致了意外的结果。

为什么你的查询不对？ #

当你写CategoryModel.objects.filter(categories__icontain=5)时，Django会把数组里的每个元素转换成字符串，然后检查是否有元素包含"5"这个子串。categoryA的categories里有562，转成字符串是"562"，里面恰好包含"5"，所以它也被匹配出来了，这就不符合你想要的“精确包含元素5”的需求。

正确的查询方式 #

对于PostgreSQL的ArrayField，Django提供了专门的查找方法来处理数组元素的精确匹配：

1. 使用__contains，传入包含目标元素的列表：

# 匹配所有categories数组中包含5的实例
CategoryModel.objects.filter(categories__contains=[5])

这个查找会检查字段的数组是否包含指定的元素（这里就是5），只会返回categoryB，完全符合你的预期。

2. 另一个等价的方法是__overlap，用于检查两个数组是否有交集：

CategoryModel.objects.filter(categories__overlap=[5])

因为我们只传了单个元素的数组，所以效果和上面的__contains完全一样，同样能精确匹配到包含5的数组。

额外说明 #

如果你的需求是数组恰好等于[5]（而不是包含5），直接用等于判断即可：

CategoryModel.objects.filter(categories=[5])

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