Symfony4+FosElasticaBundle的ElasticSearch多值匹配查询求助

嘿，我之前在Symfony 4项目里用FOSElasticaBundle操作ElasticSearch时，也踩过terms查询的类似坑，给你梳理下问题原因和解决办法：

核心问题分析 #

你碰到的情况大概率是两个原因之一：

1. 字段类型不匹配：如果你的code字段定义为text类型，ElasticSearch会对它做分词处理，而terms查询是精确匹配原始词项的，这时候直接查code字段就会找不到结果；
2. Should查询的默认行为：当Bool查询里只有Should子句且没设置minimum_should_match时，ElasticSearch默认允许匹配0个条件，所以会返回所有文档。

具体解决方案 #

方案1：针对Text字段使用Keyword子字段查询 #

如果你的code字段是text类型（默认配置），ElasticSearch会自动生成一个code.keyword的子字段（存储原始未分词的值），这时候把terms查询指向这个子字段就行：

// 假设你在Repository里操作
$finder = $this->getContainer()->get('fos_elastica.finder.your_index.your_entity');

// 构建Terms查询
$termsQuery = new \Elastica\Query\Terms();
$termsQuery->setTerms('code.keyword', ['first', 'second', 'third']);

// 执行查询
$results = $finder->find($termsQuery);

方案2：修改字段映射为Keyword类型 #

如果code字段本来就应该是精确匹配的（比如是编码、枚举值），直接把它的映射改成keyword类型更合理，这样以后查询不用加.keyword：

在config/packages/fos_elastica.yaml里修改你的实体映射：

fos_elastica:
    indexes:
        your_index_name:
            types:
                your_entity_name:
                    properties:
                        code:
                            type: keyword # 替换原来的text类型

修改后记得重新生成索引：

php bin/console fos:elastica:populate

方案3：正确配置Should查询的匹配规则 #

如果你一定要用Should查询，必须设置minimum_should_match为1，确保只有匹配至少一个terms的文档才会被返回：

$boolQuery = new \Elastica\Query\BoolQuery();
$termsQuery = new \Elastica\Query\Terms('code.keyword', ['first', 'second', 'third']);

$boolQuery->addShould($termsQuery);
$boolQuery->setMinimumShouldMatch(1); // 关键：要求至少匹配1个Should条件

$finder = $this->getContainer()->get('fos_elastica.finder.your_index.your_entity');
$results = $finder->find($boolQuery);

验证小技巧 #

可以先用ElasticSearch的Dev Tools执行原生查询，确认字段和查询语句是否正确：

GET your_index/_search
{
  "query": {
    "terms": {
      "code.keyword": ["first", "second", "third"]
    }
  }
}

如果这个原生查询能得到正确结果，再对应调整FOSElasticaBundle的代码就没问题了。

内容的提问来源于stack exchange，提问作者Clément Andraud