Elasticsearch匹配ARK前缀查询报错及正确查询编写需求

需求说明 #

有一个名为number的字段，有效值均以"ARK"开头，示例如下：

number
ARK101223
ARK123422
ARK234002
ARK234177

需要筛选出包含该字段且值以ARK开头的记录，同时忽略无number字段的记录，还要按指定日期字段排序。

原查询及报错 #

原查询语句 #

{
  "query": {
    "bool": {
      "must": [
        {
          "prefix": {
            "number.keyword": "ARK"
          }
        },
        {
          "range": {
            "date_1": {
              "gte": "2022-01-01 01:00:00",
              "lte": "2022-03-10 01:00:00"
            }
          },
          "sort": [
            {
              "date_1": {
                "order": "asc"
              },
              "date_2": {
                "order": "asc"
              },
              "ts": {
                "order": "asc"
              }
            }
          ]
        }
      ]
    }
  }
}

报错信息（翻译后） #

{
    "error": {
        "root_cause": [
            {
                "type": "解析异常",
                "reason": "[range] 查询格式错误，预期为[END_OBJECT]但找到[FIELD_NAME]",
                "line": 1,
                "col": 155
            }
        ],
        "type": "x_content解析异常",
        "reason": "[1:155] [bool] 解析字段[must]失败",
        "caused_by": {
            "type": "解析异常",
            "reason": "[range] 查询格式错误，预期为[END_OBJECT]但找到[FIELD_NAME]",
            "line": 1,
            "col": 155
        }
    },
    "status": 400
}

错误原因 #

核心问题是**sort字段的位置错误**：sort是Elasticsearch查询的顶层参数，必须和query同级，不能嵌套在bool的must数组元素里。原查询把sort和range放在同一个对象中，导致JSON结构不符合语法规范。

另外，原查询没有明确过滤无number字段的记录，虽然prefix查询不会匹配不存在该字段的文档，但加上exists查询可以更精准地满足需求。

修复后的查询语句 #

{
  "query": {
    "bool": {
      "must": [
        {
          "exists": {
            "field": "number"
          }
        },
        {
          "prefix": {
            "number.keyword": "ARK"
          }
        },
        {
          "range": {
            "date_1": {
              "gte": "2022-01-01 01:00:00",
              "lte": "2022-03-10 01:00:00"
            }
          }
        }
      ]
    }
  },
  "sort": [
    {
      "date_1": {
        "order": "asc"
      }
    },
    {
      "date_2": {
        "order": "asc"
      }
    },
    {
      "ts": {
        "order": "asc"
      }
    }
  ]
}

关键说明 #

• exists查询：确保只返回包含number字段的文档，精准满足“忽略无number字段记录”的需求。
• prefix查询：使用number.keyword字段匹配以"ARK"开头的值，keyword类型为精确匹配，避免分词干扰结果。
• sort位置修正：将sort移到顶层与query同级，符合Elasticsearch查询语法规范。

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