Sphinx Search wordforms映射问题：heartburn无法匹配所有含rennie记录

1. 先核对wordforms的配置与加载 #

• 检查sphinx配置文件里的wordforms参数，确认路径指向正确的文件，且文件用UTF-8编码（不要带BOM）。
• 打开wordforms文件，确保只有heartburn > rennie这一条规则，别写反成rennie > heartburn，也不要有其他冲突规则。
• 修改wordforms后必须重新生成索引（执行indexer mytbl），如果用的是非实时索引，还要重启searchd服务——很多时候就是漏了这步导致规则没生效。

2. 验证查询的处理流程 #

执行call keywords('heartburn', 'mytbl');查看输出：

• 正常情况应该是：tokenized为heartburn，normalized为rennie，经过词干处理后最终得到renn（和你索引中存储的词一致，毕竟搜Rennie能匹配到含renn的记录）。
• 如果输出不符合预期，检查morphology配置（比如是否开启了英文词干提取），确保wordforms在词干提取之前生效——Sphinx默认顺序是先做wordforms替换再处理词干，要是你改过顺序得调回来。

3. 修正查询语句的多余空格 #

你之前用的match('heartburn ')带了尾空格，可能会被分词成heartburn加空token，干扰匹配。换成select * from mytbl where match('heartburn');试试。

4. 直接映射到索引中的词 #

要是词干提取环节出问题，直接把wordforms规则改成heartburn > renn，跳过词干提取步骤，直接匹配索引里存储的renn，这样大概率能拿到所有3条目标记录。

5. 检查过滤参数是否拦截了关键词 #

核对配置里的min_word_len、ignore_chars等参数，确保它们没有过滤掉heartburn、rennie或者renn——比如min_word_len设为5的话，renn就会被过滤掉。

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