Elasticsearch term查询无法匹配sellerId字段问题求助

这问题我之前在ES 2.x版本里碰到过，核心原因大概率是字段分词逻辑或者映射类型设置导致的，咱们一步步拆解：

1. 为什么term查询匹配不到？ #

ES的term查询是精确匹配，只会和倒排索引里的原始token完全一致才会命中。而你用的ES 2.2.2中，默认的string类型字段是analyzed（分词）状态，标准分词器会把你的UUID（6dd7035e-1d6f-4ddb-82f4-521902bfc29e）按连字符拆分成多个独立的token（比如6dd7035e、1d6f、4ddb等）。倒排索引里存的是这些拆分后的片段，你用完整的UUID做term查询，自然找不到匹配的记录。

其他字段查询正常，大概率是因为那些字段是数字、日期这类本身不分词的类型，或者是提前设置了not_analyzed的字符串字段，所以term能精确匹配。

2. 验证问题的方法 #

先确认sellerId字段的映射类型，执行以下命令：

GET /你的索引名/_mapping/你的文档类型

查看返回结果里sellerId的index属性，如果是analyzed，那就是问题根源。

另外可以用分析API看UUID被拆分后的token：

POST /_analyze
{
  "analyzer": "standard",
  "text": "6dd7035e-1d6f-4ddb-82f4-521902bfc29e"
}

执行后会看到被拆成多个小token，这就坐实了分词导致的匹配问题。

3. 可行的解决方案 #

方案一：修改字段映射为不分词（需重新索引数据） #

如果你的数据量不大，或者可以接受重新索引，直接修改映射，把sellerId设为not_analyzed：

PUT /你的索引名/_mapping/你的文档类型
{
  "properties": {
    "sellerId": {
      "type": "string",
      "index": "not_analyzed"
    }
  }
}

修改完成后，需要重新导入所有数据（因为旧数据的分词结果不会自动更新），之后再用原来的term查询就能命中了。

方案二：使用自动生成的.raw子字段查询（无需修改映射） #

ES 2.x中，默认的string类型字段会自动生成一个.raw的子字段，这个子字段是not_analyzed状态的。你可以直接修改查询条件，把sellerId换成sellerId.raw：

{ 
  "query": { 
    "filtered": { 
      "query": { 
        "match_all": [ ] 
      }, 
      "filter": { 
        "and": [ 
          { "term": { "sellerId.raw": "6dd7035e-1d6f-4ddb-82f4-521902bfc29e" } } 
        ] 
      } 
    } 
  } 
}

这个方法不需要修改映射或重新索引，直接就能生效，适合不想动现有数据的场景。

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