Solr 8.8.0 SynonymGraphFilterFactory不生效 synonyms.txt未加载问题咨询

• 排查Solr运行日志：打开Solr实例下server/logs/solr.log日志文件，搜索SynonymGraphFilterFactory、synonyms相关关键词。如果文件加载成功会输出类似Loaded X synonym rules from synonyms.txt的记录；如果加载失败会明确抛出FileNotFoundException、文件编码错误、规则格式错误的警告。如果没有任何相关日志，说明配置未被识别加载。
• 核对文件路径与权限：确认synonyms.txt放在对应Core的独立conf目录下，路径一般为server/solr/你的Core名称/conf/，而非Solr全局的conf目录。同时检查Solr运行的系统用户拥有该文件的可读权限，避免权限不足无法读取。
• 验证文件编码与规则格式：文件必须为UTF-8无BOM编码，不要用Windows系统自带记事本保存（会默认插入BOM头导致解析失败）。规则需要使用半角逗号分隔，逗号前后不要加多余空格（除非你要匹配带空格的词汇），避免全角符号、特殊字符混入规则。

• 正确使用Solr UI分析工具：进入分析页面后，首先要选择你业务字段绑定的text_general字段类型/对应业务字段，不要选错成string等其他类型。勾选「Verbose Output」详细输出选项后输入测试词，查看SynonymGraphFilterFactory步骤的输出，如果没有出现同义词扩展结果，说明过滤器未生效。
• 查查询解析结果：搜索时添加debug=query参数，查看返回结果中parsedquery部分的内容。如果同义词生效，搜索blablabla会被解析为blablabla OR test，如果仅出现原词说明未触发同义词扩展。
• 异常规则测试：在synonyms.txt中加入一行明显格式错误的规则（比如test,）后重启Solr，若日志中出现同义词解析报错，说明文件确实被读取，问题出在规则或配置逻辑上；若无报错则说明文件根本未被加载。

你大概率是配置文件放错了位置：fieldType字段类型的配置需要写在Core的managed-schema（或schema.xml）文件中，而不是solr-data-config.xml里，后者仅用于配置数据导入的规则，不会生效字段分析链的配置。你可以先去Solr UI的Schema页面，查看text_general的配置是否和你写的一致，确认配置已被正确加载。

另外你贴的分析输出中最后一步输出的blablabl比原词少了一个a，可以核对下同义词规则里的拼写是否和测试词完全一致，避免拼写错误导致匹配失败。

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