Elasticsearch 7.17多过滤器与multi_match结合查询语法错误排查

你的问题出在bool查询的filter字段格式上：当存在多个过滤条件时，filter必须是一个数组，每个过滤条件作为数组的独立元素。你当前的写法是把term和range直接放在同一个对象里，这不符合Elasticsearch的语法规范。

错误原因解析 #

Elasticsearch的bool查询中，filter字段接受两种形式：

• 单个过滤条件：可以直接写为一个查询对象（比如单独的term或range）
• 多个过滤条件：必须用数组包裹，每个条件是数组的一个元素

你同时放两个条件时，ES解析到第一个term对象后，又遇到了range这个额外的字段名，就会触发"expected [END_OBJECT] but found [FIELD_NAME]"的解析错误。

修正后的PHP代码 #

把filter改成数组形式，每个过滤条件单独作为数组元素：

'query' => [
    'bool' => [
        'must' => [
            'multi_match' => [
                'query' => $keywords,
                'fields' => [
                    'title^4',
                    'subtitle^4',
                ]
            ],
        ],
        'filter' => [
            [
                'term' => [
                    'status' => 'live'
                ]
            ],
            [
                'range' => [
                    'published_date' => [
                        'lte' => '2022-11-01'
                    ]
                ]
            ]
        ]
    ]
]

验证语法正确性 #

修正后生成的JSON查询结构会变成：

{
  "query": {
    "bool": {
      "must": [
        {
          "multi_match": {
            "query": "...",
            "fields": ["title^4", "subtitle^4"]
          }
        }
      ],
      "filter": [
        {"term": {"status": "live"}},
        {"range": {"published_date": {"lte": "2022-11-01"}}}
      ]
    }
  }
}

这种结构完全符合Elasticsearch 7.17的语法规范，两个过滤条件会被正确解析并同时生效。

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