Django集成PostgreSQL时索引失效求助：索引未被使用仍执行Seq Scan

嘿，我来帮你拆解下这个问题，从几个关键角度排查：

首先，先说说数据量的事儿——你数据库里只有1000条记录，PostgreSQL的查询优化器其实会觉得全表扫描（Seq Scan）比走索引更快。因为索引需要额外的IO去定位数据块，对于小数据集来说，直接扫全表的开销反而更低。你可以试试把数据量加到几万条再测试，或者临时关闭全表扫描验证索引是否能生效（执行SET enable_seqscan = off;后再跑查询，注意这只是测试用，别在生产环境这么搞）。

接下来针对你两个查询分别分析：

1. created__year__lte=2022 不触发BrinIndex的问题 #

你给created字段建了BrinIndex，但created__year本质是用函数提取年份的操作（对应SQL里的date_part('year', created) <= 2022），普通的字段索引对这种函数表达式查询是不生效的。要让这个查询用上索引，得创建表达式索引：

你可以在Employee模型的Meta里新增一个针对年份提取的BrinIndex：

from django.db.models.functions import ExtractYear
from django.contrib.postgres.indexes import BrinIndex

class Employee(models.Model):
    # ... 其他字段
    class Meta:
        indexes = (
            BrinIndex(fields=('created',), name="hr_employee_created_ix", pages_per_range=2 ),
            # 新增针对年份的表达式索引
            BrinIndex(fields=[ExtractYear('created')], name="hr_employee_created_year_ix"),
        )

生成迁移并执行后，这个年份查询就能匹配到索引了。

2. about__contains='Test' 不触发db_index的问题 #

你给about加了db_index=True，这会创建普通的B-tree索引，但__contains对应的是SQL的LIKE '%Test%'——这种开头带通配符的模糊查询，B-tree索引是不支持的。要加速这类查询，得用PostgreSQL的pg_trgm扩展配合GIN/GIST索引：

步骤1：启用pg_trgm扩展 #

先创建一个迁移文件来安装扩展：

from django.contrib.postgres.operations import TrigramExtension
from django.db import migrations

class Migration(migrations.Migration):
    dependencies = [
        # 这里填你当前的迁移依赖，比如('your_app', '000x_xxx')
    ]

    operations = [
        TrigramExtension(),
    ]

执行这个迁移。

步骤2：给about字段加trigram索引 #

修改Employee模型，替换普通索引为GIN trigram索引：

from django.contrib.postgres.indexes import GinIndex

class Employee(models.Model):
    # 先把原来的db_index=True去掉，避免重复索引
    about = models.CharField(max_length=10000)
    # ... 其他字段
    class Meta:
        indexes = (
            BrinIndex(fields=('created',), name="hr_employee_created_ix", pages_per_range=2 ),
            BrinIndex(fields=[ExtractYear('created')], name="hr_employee_created_year_ix"),
            # 新增trigram索引
            GinIndex(fields=['about'], name='hr_employee_about_trgm_idx'),
        )

再生成并执行迁移，之后__contains查询就能用上索引了。

最后确认索引是否存在 #

你可以登录PostgreSQL数据库，执行\d 你的表名（比如\d hr_employee，Django默认表名是app名_模型名小写），查看索引列表，确认你定义的所有索引都已经被正确创建，避免迁移没执行到位的情况。

另外提一句：HashIndex只适用于精确匹配查询（比如about='Test'），而且PostgreSQL里B-tree索引比HashIndex更通用，你这个场景用HashIndex本来就不合适，不用纠结它没生效的问题。

内容来源于stack exchange