PostgreSQL全文检索to_tsvector未走索引：为何用Seq Scan而非Bitmap Heap Scan？

问题背景 #

环境：psql (PostgreSQL) 15.4 (Homebrew)

创建的GIN索引：

CREATE INDEX movies_title_searchable ON movies USING gin(to_tsvector('english', title));

执行的查询语句：

EXPLAIN ANALYZE
SELECT title
FROM movies
WHERE to_tsvector('english', title) @@ to_tsquery('english', 'night & day') LIMIT 1;

实际执行计划：

->  Seq Scan on movies  (cost=0.00..2.31 rows=1 width=32) (actual time=0.035..0.035 rows=1 loops=1)
        Filter: (to_tsvector('english'::regconfig, title) @@ '''night'' & ''day'''::tsquery)
        Rows Removed by Filter: 3

原因分析 #

• 表数据量极小：从执行计划可见，仅扫描4行就找到了匹配项。PostgreSQL优化器会评估成本，对于极小的表，顺序扫描无需额外读取索引、再定位堆表数据的开销，直接扫全表的成本反而更低。
• LIMIT 1的触发逻辑：查询包含LIMIT 1，优化器判断顺序扫描可以在找到第一个匹配行后立即终止扫描；而使用索引的话，需要先遍历索引找到匹配条目，再去堆表获取对应数据，这个流程的启动成本比直接扫表直到找到首个匹配更高。

验证方法 #

如果想验证索引是否能正常生效，可以尝试以下操作：

• 移除LIMIT 1后重新执行EXPLAIN ANALYZE，观察执行计划是否切换为索引扫描
• 向movies表插入大量测试数据，当数据量达到一定规模后，优化器会自动选择使用索引进行扫描

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