Magento 2.4.6 OpenSearch搜索同义词配置后不生效求助

问题场景 #

已在Magento中配置OpenSearch同义词功能：创建同义词组并添加逗号分隔的同义词，执行全量重索引后，通过API搜索“cucumber”能返回对应商品，但搜索其同义词时无结果。已确认vendor/magento/module-open-search/etc/search_engine.xml中synonyms支持为true，需排查问题原因。

相关代码与API示例 #

API调用示例（搜索“cucumber”有效） #

http://website/rest/V1/products?searchCriteria[filter_groups][0][filters][0][field]=name&searchCriteria[filter_groups][0][filters][0][value]=%25cucumber%25&searchCriteria[filter_groups][0][filters][0][condition_type]=like&searchCriteria[pageSize]=5&searchCriteria[currentPage]=1

已确认的搜索引擎配置 #

<engines xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:Search/etc/search_engine.xsd">
    <engine name="opensearch">
        <feature name="synonyms" support="true" />
    </engine>
</engines>

排查与解决步骤 #

• 核心问题：搜索方式不触发同义词逻辑
  当前使用的是like条件过滤name字段的方式，属于数据库层面的模糊匹配，不会调用OpenSearch的全文分析器，因此同义词不会生效。需改用Magento的全文搜索API，示例：

  http://website/rest/V1/products?searchCriteria[requestName]=quick_search_container&searchCriteria[filter_groups][0][filters][0][field]=search_term&searchCriteria[filter_groups][0][filters][0][value]=[你的同义词]&searchCriteria[pageSize]=5&searchCriteria[currentPage]=1
  

• 验证同义词组配置
  确认同义词组格式正确（如cucumber,cuke）且处于启用状态，检查Magento后台的同义词组是否保存成功。

• 确认索引同步与状态
  执行bin/magento indexer:status查看catalogsearch_fulltext索引状态，确保全量重索引已完成（状态为Ready）。若索引未同步，同义词不会被加载到OpenSearch中。

• 检查OpenSearch索引的分析器配置
  登录OpenSearch控制台，查看商品索引的分析器设置，确认同义词过滤器已正确关联到索引分析器和搜索分析器。

• 清除系统缓存
  执行bin/magento cache:flush清除所有缓存，确保配置变更生效。

• 版本兼容性检查
  确认OpenSearch版本与当前使用的Magento版本兼容，部分旧版本可能存在同义词支持的bug。

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