如何在Java中用QueryBuilder从Elasticsearch查询含下划线的字符串值？

我来帮你梳理清楚这个问题的根源和解决办法：

问题核心原因 #

你当前用termQuery("myObject.code", value)查询的是text类型的主字段，而Elasticsearch的text字段会经过默认分词器处理：

• 对于中间带下划线的字符串（比如FOO_BAR），在ES 3.2.7的标准分词器规则下，会被拆分成FOO和BAR两个独立的词项（term）。当你用termQuery匹配完整的FOO_BAR时，分词后的字段里根本不存在这个完整term，自然查不到结果。
• 而首尾带下划线的字符串（比如_FOO或FOO_），分词器不会拆分它们，会保留为一个完整的term，所以你的termQuery能正常匹配到对应文档。

你知道keyword字段支持精确匹配，但并没有在查询中指定它——这就是问题的关键！

解决方案 #

修改查询语句，直接指向myObject.code.keyword这个keyword子字段，就能实现精准匹配：

boolQuery.must(termQuery("myObject.code.keyword", value));
var results = searchRepository.search(boolQuery);

为什么这样有效？ #

myObject.code.keyword是keyword类型字段，它会完全保留原始字符串的格式（包括大小写、下划线、特殊符号等），不会进行任何分词处理。当你用termQuery查询这个字段时，Elasticsearch会直接匹配完整的字符串，不管下划线在什么位置都能精准命中。

额外验证建议 #

如果你想确认分词器的处理逻辑，可以用ES的_analyzeAPI测试：

GET /_analyze
{
  "text": "FOO_BAR",
  "analyzer": "standard"
}

在ES 3.2.7中，这个请求会返回foo和bar两个词项，这也能直观解释为什么你用termQuery查询text字段找不到结果。

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