Java项目中使用Elasticsearch索引java.util.Map及创建映射的技术咨询

首先肯定你的需求是完全可行的，但当前的nested映射配置和Java Map的默认序列化结构不匹配，咱们来拆解问题并给出解决方案：

先搞清楚核心问题：Java Map的JSON序列化结构 #

你的metadata是Map<String,String>，默认序列化成JSON后是这样的结构：

"metadata": {
  "key1": "value1",
  "key2": "value2"
}

而你配置的nested类型需要的是数组结构，比如：

"metadata": [
  {"key": "key1", "value": "value1"},
  {"key": "key2", "value": "value2"}
]

所以直接用当前的映射，Elasticsearch没法正确识别Map里的键值对，会导致metadata.key和metadata.value字段没有数据。

两种可行的解决方案 #

方案1：调整Java对象结构，适配Nested映射 #

如果需要对key-value对做复杂查询、聚合（比如同时匹配某个key和对应的value），推荐用这种方式：

1. 定义一个简单的KeyValue实体类：

public class KeyValue {
    private String key;
    private String value;

    // 构造方法、getter、setter
    public KeyValue(String key, String value) {
        this.key = key;
        this.value = value;
    }

    // 无参构造用于序列化
    public KeyValue() {}
}

2. 修改NextEvent类的metadata字段类型：

private List<KeyValue> metadata;

或者如果不想修改字段类型，可以用Jackson的自定义序列化器，把Map自动转成KeyValue数组（比如添加@JsonSerialize(using = MapToKeyValueArraySerializer.class)注解）。

这样调整后，你原来的nested映射就能正常工作了，查询时可以用nested查询来精准匹配键值对：

{
  "query": {
    "nested": {
      "path": "metadata",
      "query": {
        "bool": {
          "must": [
            {"term": {"metadata.key": "user"}},
            {"term": {"metadata.value": "Alice"}}
          ]
        }
      }
    }
  }
}

方案2：使用Elasticsearch的Flattened类型（无需修改Java代码） #

如果你的需求只是简单的键值查询，不想改动Java代码，推荐用ES 7.0+提供的flattened类型，它专门用来处理动态键值对，避免mapping膨胀。修改后的映射如下：

"mappings": {
  "nextevent": {
    "properties": {
      "executed": {"type": "boolean"},
      "executionDate": {"type": "date"},
      "type": {"type": "keyword"}, // 注意：ES 5.x+已经用keyword代替not_analyzed的string
      "metadata": {"type": "flattened"}
    }
  }
}

注意：你的原映射里用了"type": "string", "index": "not_analyzed"，在ES 5.x及以后版本，string类型已经被拆分成text和keyword，not_analyzed对应keyword类型，建议同步修改。

使用flattened类型后，你可以直接用原生的Java Map，查询时这样写：

// 查询metadata中包含key为user的文档
{ "query": { "term": {"metadata.user": "Alice"} } }

// 查询metadata中value包含某个值的文档
{ "query": { "term": {"metadata": "Alice"} } }

这种方式的缺点是不支持复杂的嵌套聚合，也不能同时精准匹配key和value，但胜在无需修改代码，适合动态键值的简单场景。

额外提醒：避免默认的Object类型 #

如果不做任何映射配置，ES会自动把Map处理成object类型，每个Map的key都会成为一个独立字段。但如果你的Map键是动态变化的（比如每次都有新的key），会导致ES的mapping不断膨胀，严重影响性能和查询效率，所以尽量不要依赖这种默认行为。

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