如何在Django模型中为布尔字段用IS创建索引条件？

可以直接通过Django模型创建带有WHERE field2 IS false条件的索引，下面提供两种可行方案：

方案1：使用RawSQL直接指定原生SQL条件 #

直接在索引的condition参数中用RawSQL写入目标SQL片段，绕过Django ORM的默认转换逻辑：

from django.db.models import Index, RawSQL

class YourModel(models.Model):
    field1 = models.IntegerField()
    field2 = models.BooleanField(null=True)  # 若字段允许NULL需显式声明

    class Meta:
        indexes = [
            Index(
                name="test_boolean_idx",
                fields=["field1", "field2"],
                condition=RawSQL("field2 IS false", []),
            ),
        ]

生成的SQL语句为：
CREATE INDEX test_boolean_idx ON yourmodel (field1, field2) WHERE field2 IS false;

方案2：自定义数据库函数实现IS false逻辑 #

如果希望保持ORM风格，避免直接写原生SQL，可以自定义函数生成IS false条件：

from django.db.models import BooleanField, Func, Q, Index, F

class IsFalse(Func):
    function = ''
    template = "%(expressions)s IS false"
    output_field = BooleanField()

class YourModel(models.Model):
    field1 = models.IntegerField()
    field2 = models.BooleanField(null=True)

    class Meta:
        indexes = [
            Index(
                name="test_boolean_idx",
                fields=["field1", "field2"],
                condition=Q(field2=IsFalse(F("field2"))),
            ),
        ]

这种方式既符合Django ORM的编码风格，又能生成正确的IS false索引条件。

补充说明 #

默认情况下，Django会把Q(field2=False)转换为NOT field2（等价于field2 = false），但数据库会将field2 IS false和field2 = false视为不同条件——当字段允许NULL时，两者虽都不匹配NULL值，但语法差异会导致数据库无法匹配已有索引。通过上述方法，能让索引条件与查询语句完全对齐，确保索引被正常触发。

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