子查询中调用to_tsvector()会导致gin索引失效，必须确保where中to_tsvector()表达式与建索引时字面完全一致；正确做法是用持久化列、lateral或预筛选id缩小结果集，并统一中文场景的'zhcn'配置。
子查询里别调用 to_tsvector()，否则索引全失效
直接在子查询的 SELECT 或 WHERE 里写 to_tsvector('english', content)，会导致每行都重新计算向量，GIN 索引完全无法命中。执行计划里会出现多个 Function Scan 或 Seq Scan，10 万行查起来可能从 50ms 拉到 3s+。
真正能走索引的方式只有一种：让 WHERE 条件中出现的 to_tsvector() 表达式，和建索引时的表达式**字面完全一致**。比如建了 CREATE INDEX idx_gin ON posts USING GIN (to_tsvector('english', content))，那查询就必须写成 WHERE to_tsvector('english', content) @@ to_tsquery(...)，不能包一层子查询再算。
- 子查询中提前算
tsvector→ 索引失效、重复计算、内存暴涨 - 想复用向量？加个持久化列（如
tsv tsvector）+ 触发器自动更新 - 实在要嵌套，用
LATERAL配合预计算列，而不是 SELECT 子查询
ORDER BY ts_rank() 前先缩小结果集，别等排序才过滤
ts_rank() 是运行时函数，没法走索引，数据量一大，光排序就卡住。更糟的是，如果外层 ORDER BY 的输入来自一个没过滤的子查询，PG 可能先算完全部 rank 再取 LIMIT，白白浪费 CPU。
正确做法是把高选择性业务条件（比如状态、时间范围、分类）提到最外层 WHERE，或用子查询先筛 ID：
- 差写法：
SELECT * FROM posts WHERE to_tsvector(...) @@ ... ORDER BY ts_rank(...) LIMIT 10→ 全表算 rank - 好写法：
SELECT * FROM posts p JOIN (SELECT id FROM posts WHERE status = 'published' AND created_at > '2025-01-01') AS f ON p.id = f.id WHERE p.tsv @@ ... ORDER BY ts_rank(p.tsv, ...) LIMIT 10 - 如果排序字段涉及权重，确保传入的是
setweight()合并后的向量，不是原始to_tsvector()
子查询返回 tsvector 必须处理 NULL 和多行
写 WHERE (SELECT tsv FROM cache WHERE post_id = p.id) @@ to_tsquery(...) 很容易报错，常见两种情况：
-
operator does not exist: tsvector @@ text→ 子查询返回NULL，导致左操作数类型推导为UNKNOWN；必须用COALESCE((SELECT tsv), ''::tsvector) -
more than one row returned→ 子查询没加LIMIT 1或聚合；即使业务上“应该只有一行”，PG 也不假设，必须显式约束 - 稳妥起见，给子查询加类型声明：
(SELECT tsv::tsvector FROM cache WHERE ... LIMIT 1)
中文场景下，子查询 + zhparser 要配对生效
英文用 'english' 配置没问题，但中文必须装 zhparser 扩展，并在所有地方统一用 'zhcn'（或你定义的配置名）。子查询里漏写配置，或混用 'chinese'（不存在）、'simple'（不分词），会导致全文检索退化成字符匹配，精度归零。
- 建索引：
CREATE INDEX idx_zh ON articles USING GIN (to_tsvector('zhcn', title || ' ' || body)) - 子查询中调用：
(SELECT to_tsvector('zhcn', title) FROM ...)，不能省略'zhcn' - 如果用了
phraseto_tsquery()，也要指定相同配置：phraseto_tsquery('zhcn', '数据库优化')
子查询本身不加速全文检索，它只是帮你把“过滤”和“匹配”拆开执行。真正快的关键，在于让每一层各司其职：子查询负责快速排除无关数据，主查询负责精准匹配与排序，而所有 tsvector 相关操作必须严格对齐索引定义——少一个单引号、多一个空格，索引就废了。
