ElasticSearch v2.3.2查询报错：[term]不支持不同字段名，需用[bool]查询

嘿，这个报错其实已经把问题说得很直白了：单个term查询只能对应一个字段，你的查询语句里肯定有某个term节点同时写了好几个字段的键值对，这在ES 2.3.2里是不允许的。虽然结果看起来对，但ES解析的时候已经抓到这个语法问题了，所以才会抛出异常。

接下来我给你拆解问题，一步步修正：

1. 先揪出错误的term写法 #

你大概率是写了类似这样的错误代码——一个term里塞了多个字段：

{
  "query": {
    "bool": {
      "filter": [
        {
          "term": {
            "status": "active",
            "type": "article"  // 这里就是坑！一个term不能同时指定多个字段
          }
        },
        {
          "not": {
            "term": { "category": "draft" }
          }
        }
      ]
    }
  }
}

正确的做法是把多个字段的term拆成独立的查询项，都放在bool的filter/must数组里：

{
  "query": {
    "bool": {
      "filter": [
        { "term": { "status": "active" } },
        { "term": { "type": "article" } },
        {
          "bool": {
            "must_not": [
              { "term": { "category": "draft" } }
            ]
          }
        }
      ]
    }
  }
}

2. 关于"not"子句的正确打开方式 #

在ES 2.3.2里，虽然有not查询类型，但更规范的做法是用bool查询的must_not子句来实现排除逻辑。你之前把not直接塞到filter里，结果对了但报错还在，其实是ES做了兼容解析，但语法本身不严谨，所以才会触发报错。

把not逻辑改成嵌套在bool里的must_not，既能保证结果正确，还能彻底消除语法错误。

3. 完整的修正示例 #

假设你原来的问题查询是这样的：

{
  "query": {
    "bool": {
      "must": [
        { "match": { "title": "elasticsearch" } },
        {
          "term": {
            "status": "published",
            "author": "john"  // 多个字段触发报错
          }
        },
        {
          "not": {
            "term": { "tag": "deprecated" }
          }
        }
      ]
    }
  }
}

修正后的正确版本应该是：

{
  "query": {
    "bool": {
      "must": [
        { "match": { "title": "elasticsearch" } },
        { "term": { "status": "published" } },
        { "term": { "author": "john" } }
      ],
      "filter": [
        {
          "bool": {
            "must_not": [
              { "term": { "tag": "deprecated" } }
            ]
          }
        }
      ]
    }
  }
}

这样调整后，每个term都只针对单个字段，排除逻辑用标准的must_not实现，既符合ES 2.3.2的语法要求，结果也能保持正确，那个烦人的query_parsing_exception也会消失啦。

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