Shopware 6前端搜索无法匹配长商品名局部关键词的配置求助

问题核心 #

前端搜索"TG 4"无法匹配商品，但后台可以，本质是前后端搜索的索引逻辑、分词规则不一致：后台直接查询数据库字段，而前端依赖搜索索引（Elasticsearch或内置数据库索引），默认配置可能过滤短词、对带空格的组合词匹配策略不同。

具体调整步骤 #

1. 调整搜索最小词长限制 #

• Elasticsearch场景：
  进入后台「设置 > 系统 > 搜索/索引」，找到Elasticsearch配置，修改分词器的最小词长为1或2（适配"TG"和"4"这类短词）。修改后执行命令更新索引：

  bin/console framework:elasticsearch:index:update
  bin/console dal:refresh:index
  

• 内置数据库搜索场景：
  默认数据库搜索会过滤过短的词，需通过自定义插件修改ProductSearchQueryBuilder服务，移除短词过滤逻辑，或调整匹配规则允许短词组合。

2. 优化短语匹配逻辑 #

通过插件监听ProductSearchCriteriaEvent事件，针对带空格的搜索词添加短语匹配规则，确保"TG 4"作为整体被匹配：

public function onProductSearchCriteria(ProductSearchCriteriaEvent $event): void
{
    $criteria = $event->getCriteria();
    $searchTerm = $event->getSearchTerm();

    if (str_contains($searchTerm, ' ')) {
        // 添加短语匹配规则
        $criteria->addFilter(new MatchFilter('product.name', [
            'query' => $searchTerm,
            'type' => 'phrase'
        ]));
    }
}

3. 重新生成搜索索引 #

修改配置后必须重建索引：

• 后台操作：进入「设置 > 系统 > 搜索/索引」，点击「重新索引」按钮。
• 命令行操作：

  bin/console dal:refresh:index
  # 若使用Elasticsearch，额外执行：
  bin/console framework:elasticsearch:index:create
  

4. 检查版本默认配置 #

Shopware 6.6.4.1可在「设置 > 商店front > 搜索」中查看是否有「最小搜索词长度」「短语匹配」等开关，直接调整对应参数。

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