Elasticsearch 7中bool查询语法错误排查及span_near使用问题

错误原因 #

你的查询语句触发[bool] malformed query, expected [END_OBJECT]错误，核心是JSON结构不符合Elasticsearch bool查询的语法规范：

• Elasticsearch的bool查询中，must、should等逻辑子句必须是数组类型，且每个bool对象内的逻辑子句键（如must）只能定义一次。
• 你在外层bool查询里重复定义了must字段：先写了"must": [{"bool": {...}}]，紧接着又写了"must": {"span_near": {...}}，这会导致JSON解析冲突；同时第二个must的值是单个对象而非数组，也违反了语法要求。

修正后的查询语句 #

将两个must子句合并到同一个数组中，修正后的完整查询如下：

{
  "query": {
    "bool": {
      "must": [
        {
          "bool": {
            "must": [
              {
                "query_string": {
                  "query": "chaudiere",
                  "default_operator": "OR",
                  "analyzer": "french",
                  "fields": ["name"],
                  "type": "cross_fields",
                  "lenient": true,
                  "fuzziness": "AUTO:10,20"
                }
              }
            ]
          }
        },
        {
          "span_near": {
            "slop": 2,
            "in_order": false,
            "clauses": [
              {
                "span_multi": {
                  "match": {
                    "fuzzy": {
                      "label": {
                        "value": "chaudiere",
                        "fuzziness": "AUTO"
                      }
                    }
                  }
                }
              }
            ]
          }
        }
      ]
    }
  },
  "filter": [
    {
      "bool": {
        "must": [
          { "term": { "store_uid": 1 } },
          {
            "bool": {
              "should": [
                {
                  "bool": {
                    "must_not": [ { "term": { "life_cycle": "FDS" } } ]
                  }
                },
                {
                  "bool": {
                    "must": [
                      { "term": { "life_cycle": "FDS" } },
                      {
                        "bool": {
                          "should": [
                            { "bool": { "must": [ { "range": { "stock": { "gt": 0 } } } ] } },
                            { "bool": { "must": [ { "range": { "stock_delivery": { "gt": 0 } } } ] } }
                          ]
                        }
                      }
                    ]
                  }
                }
              ]
            }
          }
        ],
        "must_not": [
          { "term": { "is_base": true } },
          { "term": { "is_replaced": true } }
        ]
      }
    }
  ]
}

额外优化建议 #

若要实现查询词在首位的文档得分高于第二位，当前span_near的in_order: false无法满足需求，需调整为：

• 将in_order设为true，确保匹配顺序；
• 可为首位匹配的子句添加boost值强化得分权重，示例：

"span_near": {
  "slop": 2,
  "in_order": true,
  "clauses": [
    {
      "span_multi": {
        "match": {
          "fuzzy": {
            "label": {
              "value": "chaudiere",
              "fuzziness": "AUTO",
              "boost": 2
            }
          }
        }
      }
    }
  ]
}

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