当tsvector_update_trigger无法满足加权需求时，必须编写自定义pl/pgsql触发器函数，显式调用setweight()为不同字段（如title设'a'、body设'b'）赋权，注意coalesce处理空值、用||拼接、return new，并针对中文启用zhparser等专用分词配置。
tsvector_update_trigger 不能满足加权需求时怎么办
内置 tsvector_update_trigger 只做简单拼接，不支持字段权重区分。比如标题应比正文更重要，它无法把 title 标为 A 权重、body 标为 B 权重——这种场景必须写自定义触发器函数。
常见错误是试图在 tsvector_update_trigger 参数里加权重标记（如 'A.title, B.body'），这会直接报错或静默失效。
- 必须用 PL/pgSQL 写函数，显式调用
setweight()包裹每个字段的to_tsvector()结果 - 注意空值处理：用
coalesce(title, '')防止整个tsvector变成NULL - 拼接多个加权向量要用
||运算符，不是字符串连接|| - 函数返回类型必须是
trigger，且结尾必须有RETURN NEW
示例函数：
CREATE OR REPLACE FUNCTION articles_tsv_update() RETURNS trigger AS $$
BEGIN
NEW.tsv :=
setweight(to_tsvector('pg_catalog.english', coalesce(NEW.title, '')), 'A') ||
setweight(to_tsvector('pg_catalog.english', coalesce(NEW.body, '')), 'B');
RETURN NEW;
END $$ LANGUAGE plpgsql;
中文分词必须绕过默认配置
直接用 'english' 或 'pg_catalog.english' 处理中文字段，结果几乎总是空 tsvector 或单个长 token，因为 PostgreSQL 原生配置依赖空格分词，而中文没有空格分隔。
验证方法：执行 SELECT to_tsvector('english', '数据库教程');，如果返回空或 '数据库教程':1，说明配置无效。
- 必须提前安装并启用中文分词插件，最常用的是
zhparser -
CREATE TEXT SEARCH CONFIGURATION chinese (PARSER = zhparser)后，还需手动添加词典映射（如ALTER TEXT SEARCH CONFIGURATION chinese ADD MAPPING FOR ngram WITH simple） - 触发器中配置名必须写你创建的配置名，例如
'chinese'，不能写'zh'或chinese（不带引号） - 若用自定义函数，
to_tsvector()第一个参数也得换成'chinese'
触发器不生效的三个隐蔽原因
执行了 UPDATE 但 tsv 列没变，不一定是代码写错，更可能是触发器被跳过或禁用。
-
tgenabled字段为D（disabled）：查SELECT tgname, tgenabled FROM pg_trigger WHERE tgrelid = 'articles'::regclass，确认是O（originally enabled） - PostgreSQL 优化跳过“无实际变更”的更新：如
UPDATE articles SET title = title，若值未变，整个行不会触发BEFORE触发器。修复方法是强制变更，例如UPDATE articles SET title = title || '' - 用了
SET col = DEFAULT：这种写法不会触发tsvector_update_trigger，必须显式赋值，哪怕赋成NULL或空字符串
GIN 索引必须建在 tsv 列上，不能建在表达式上
有人图省事想跳过 tsv 列，直接在查询里写 WHERE to_tsvector('english', title || ' ' || body) @@ to_tsquery(...)，再给这个表达式建索引——这不可靠，且性能差。
- 表达式索引（如
CREATE INDEX ON articles USING GIN (to_tsvector('english', title || ' ' || body))）要求每次查询都**完全复现相同表达式**，多一个空格或换顺序就无法命中索引 - 实时计算每次都要走完整分词流程（停用词过滤、词干提取等），CPU 开销随文本长度线性增长
- 预存的
tsv列 +USING GIN(tsv)索引，查询时只做向量匹配，不重复解析，性能提升通常在 5–20 倍 - 建索引时加
CONCURRENTLY避免锁表：CREATE INDEX CONCURRENTLY idx_articles_tsv ON articles USING GIN (tsv)
加权、中文、触发器启用状态、索引位置——这四个点漏掉任何一个，全文检索都会“看起来能跑，实际查不到”或“查得到但慢得离谱”。尤其注意中文配置和触发器是否真在运行，这两处最容易在线上环境突然失效。
