Django过滤PostgreSQL数组元素时类型转换异常问题求助

问题根源 #

Django的数组索引查询（如bool_array__0=True）会错误地将右侧的布尔值转换为布尔数组类型，导致SQL中出现bool_array[1] = true::boolean[]这种类型不匹配的比较。

解决方法 #

1. 使用Func构造正确的元素提取逻辑

通过Func手动提取数组的第一个元素，再与布尔值比较，避免Django自动转换类型：

from django.db.models import Func, BooleanField

MyModel.objects.annotate(
    first_element=Func('bool_array', 1, function='ARRAY', output_field=BooleanField())
).filter(first_element=True)

该方法生成的SQL为WHERE bool_array[1] = true，类型匹配正确。

2. 直接使用RawSQL指定过滤条件

如果需要更直接的方式，用RawSQL直接编写正确的SQL片段：

from django.db.models import RawSQL

MyModel.objects.filter(RawSQL('bool_array[1] = %s', (True,)))

这种方式绕过Django的自动类型转换，直接生成符合预期的SQL。

3. 自定义可复用的查询表达式（可选）

如果需要多次使用该筛选逻辑，可以自定义一个查询表达式：

from django.db.models import Func, BooleanField

class ArrayFirstElement(Func):
    function = 'ARRAY'
    output_field = BooleanField()

    def __init__(self, array_field, **kwargs):
        super().__init__(array_field, 1, **kwargs)

# 调用示例
MyModel.objects.annotate(first_bool=ArrayFirstElement('bool_array')).filter(first_bool=True)

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