PHP展开运算符构建Elasticsearch查询与硬编码查询结果不一致的原因

嘿，我来帮你捋捋这个问题！看起来你把原本硬编码的Elasticsearch查询改成用PHP展开运算符重构后，结果数量和预期的1500条差得远了？先看看你原来的硬编码核心代码：

private function phraseQuery(array $matchFields): array {
    return [
        'bool' => [
            "minimum_should_match" => 1,
            "should" => [
                $this->multiMatch($matchFields),
                [
                    'match' => [
                        'Title' => [
                            'query' => $this->searchTerm,
                            'fuzziness' => 'AUTO:4,8'
                        ]
                    ]
                ], 
                [
                    'match' => [
                        'TransliteratedTitle' => [
                            'query' => $this->searchTerm,
                            'fuzziness' => 'AUTO:4,8'
                        ]
                    ]
                ]
            ]
        ]
    ];
}

这种情况下，用展开运算符重构后结果不一致，大概率是数组结构在重构时变了，导致Elasticsearch解析的查询逻辑和原来不一样。我给你列几个最可能的坑：

• 展开的数组结构不对，导致查询条件丢失或层级错误
  比如你可能把两个match查询放到了同一个关联数组里（用'match'当键），然后用...展开：

  // 错误示范！关联数组的重复键会被覆盖
  private function getFuzzyQueries() {
      return [
          'match' => ['Title' => ['query' => $this->searchTerm, 'fuzziness' => 'AUTO:4,8']],
          'match' => ['TransliteratedTitle' => ['query' => $this->searchTerm, 'fuzziness' => 'AUTO:4,8']]
      ];
  }
  
  // 重构后的should
  "should" => [
      $this->multiMatch($matchFields),
      ...$this->getFuzzyQueries()
  ]
  

  这里两个'match'键会被覆盖，最后should里只剩针对TransliteratedTitle的查询，条件少了一个，结果自然少了。正确的做法是让getFuzzyQueries()返回包含两个独立数组的索引数组：

  // 正确写法
  private function getFuzzyQueries() {
      return [
          [
              'match' => ['Title' => ['query' => $this->searchTerm, 'fuzziness' => 'AUTO:4,8']]
          ],
          [
              'match' => ['TransliteratedTitle' => ['query' => $this->searchTerm, 'fuzziness' => 'AUTO:4,8']]
          ]
      ];
  }
  

• fuzziness参数被误改或丢失
  重构时如果不小心把'AUTO:4,8'改成了别的值（比如只写了AUTO），或者生成数组时漏传了这个参数，模糊匹配的宽松程度就变了，结果数量肯定会有差异。

• minimum_should_match设置被覆盖
  原代码里minimum_should_match是1，意味着只要匹配should里任意一个条件就算命中。如果重构时这个值被改成了2或者其他数，就需要匹配多个条件，结果数量会骤减。

• multiMatch方法的返回值变了
  如果重构时你修改了multiMatch方法的逻辑（比如改了匹配字段、匹配类型），那这个查询的结果本身就变了，整体结果自然不一致。

快速排查步骤 #

1. 把原硬编码查询和重构后的查询都用json_encode()输出，对比JSON结构，看should数组的元素数量、每个元素的键值对是不是完全一致。
2. 重点检查两个match查询里的fuzziness参数是否存在且值正确。
3. 确认minimum_should_match的值还是1，没有被修改。

备注：内容来源于stack exchange，提问作者Martin Uildriks