PostgreSQL全文搜索突然无结果问题求助

1. 排查搜索词的TSQuery转换异常 #

先手动执行查询，替换:terms为已知存在的关键词，验证基础查询逻辑：

select * from posts 
where approved=true 
and (to_tsvector('english', (json->>'name') || ' ' || (json->>'city') || ' ' || (json->>'state') || ' ' || (json->>'abbr') || ' ' || (json->>'category') || ' ' || (json->>'subcategory')) @@ to_tsquery('english', 'your_existing_keyword')) 
limit 200;

如果手动查询有结果，说明PHP PDO的参数替换存在问题：

• 检查是否在替换时添加了多余引号（比如把'keyword'变成''keyword''），导致TSQuery解析失败
• 确认是否对搜索词做了不必要的转义（比如空格被转义成%20），破坏TSQuery的语法

2. 验证索引与查询的TSVector表达式一致性 #

索引生效的前提是查询中的to_tsvector表达式和索引定义完全一致，执行以下语句导出索引定义，和查询语句逐字符对比：

select indexdef from pg_indexes where indexname = 'posts_full_text_search_json_idx';

常见不一致情况：JSON字段引用错误（比如把json->>'name'写成json->'name'）、拼接空格数量不同、字段顺序差异等

3. 处理空JSON字段导致的无效TSVector #

若部分记录的JSON字段为空，拼接后的字符串会是空值，to_tsvector生成空向量无法匹配任何查询。先统计这类记录：

select count(*) from posts 
where (json->>'name') is null 
or (json->>'city') is null 
or (json->>'state') is null 
or (json->>'abbr') is null 
or (json->>'category') is null 
or (json->>'subcategory') is null;

如果存在此类记录，修改TSVector表达式用coalesce处理空值，再重建索引：

drop index posts_full_text_search_json_idx;
create index posts_full_text_search_json_idx on posts using gin (
to_tsvector('english', coalesce(json->>'name','') || ' ' || coalesce(json->>'city','') || ' ' || coalesce(json->>'state','') || ' ' || coalesce(json->>'abbr','') || ' ' || coalesce(json->>'category','') || ' ' || coalesce(json->>'subcategory',''))
);

4. 检查文本搜索配置是否被篡改 #

english文本搜索配置若被修改（比如停用词列表变更），会导致关键词被过滤。先查看当前配置：

select * from pg_ts_config where cfgname = 'english';

若配置异常，重置为默认：

alter text search configuration english reset;

5. 强制索引查询排除规划器异常 #

偶尔PostgreSQL查询规划器会选择不走索引，改用全表扫描时出现异常，可强制指定索引：

select * from posts index (posts_full_text_search_json_idx)
where approved=true 
and (to_tsvector('english', (json->>'name') || ' ' || (json->>'city') || ' ' || (json->>'state') || ' ' || (json->>'abbr') || ' ' || (json->>'category') || ' ' || (json->>'subcategory')) @@ to_tsquery('english', :terms)) 
limit 200;

6. 验证数据本身的存在性 #

执行全表模糊查询，确认目标数据确实存在：

select * from posts where approved=true and (json->>'name' ilike '%your_keyword%' or json->>'city' ilike '%your_keyword%') limit 200;

如果该查询无结果，说明数据可能被意外删除或approved字段被批量修改；如果有结果但全文搜索无返回，说明TSVector生成或TSQuery匹配逻辑存在问题

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