Spring Data ElasticSearch：如何存储含动态字段的文档？

完全可以采用动态字段映射来处理这种场景——既保留已知字段的固定映射规则，又能对未知键的动态字段进行统一的类型转换（比如把日期格式的字符串自动映射为date类型而非字符串或时间戳）。

以下是两种常见实现方式的示例：

1. Spring Data Elasticsearch 注解+自定义映射文件实现 #

如果你用Spring Data Elasticsearch框架，可以通过实体类注解结合自定义映射文件来配置：

实体类代码 #

import org.springframework.data.elasticsearch.annotations.Document;
import org.springframework.data.elasticsearch.annotations.Field;
import org.springframework.data.elasticsearch.annotations.FieldType;
import org.springframework.data.elasticsearch.annotations.Mapping;
import org.springframework.data.elasticsearch.annotations.Dynamic;

@Document(indexName = "my_index")
// 指定自定义映射文件路径
@Mapping(mappingPath = "elasticsearch/mappings/my-class-mapping.json")
public class MyClass {
    @Field(type = FieldType.Keyword)
    private String fieldA;

    @Field(type = FieldType.Text)
    private String fieldB;

    // 开启dynamic模式，允许动态字段映射
    @Field(type = FieldType.Object, dynamic = Dynamic.TRUE)
    private Map<String, Object> dynamicFields;
}

自定义映射文件（my-class-mapping.json） #

在映射文件中通过dynamic_templates定义动态字段的类型规则，比如自动识别日期格式：

{
  "dynamic_templates": [
    {
      "auto_date_fields": {
        "match_mapping_type": "string",
        // 匹配键名包含date的字段（可根据需求调整匹配规则）
        "match": "*date*",
        "mapping": {
          "type": "date",
          // 支持多种日期格式，可根据业务需求扩展
          "format": "yyyy-MM-dd HH:mm:ss||yyyy-MM-dd||epoch_millis"
        }
      }
    },
    {
      "auto_numeric_fields": {
        "match_mapping_type": "string",
        "match": "*num*",
        "mapping": {
          "type": "double"
        }
      }
    }
  ]
}

2. 直接通过Elasticsearch API创建索引映射 #

如果不使用Spring Data，可直接调用ES的索引创建API，在mappings中配置动态字段规则：

PUT /my_index
{
  "mappings": {
    "properties": {
      "fieldA": {
        "type": "keyword"
      },
      "fieldB": {
        "type": "text"
      },
      "dynamicFields": {
        "type": "object",
        "dynamic_templates": [
          {
            "auto_date_fields": {
              "match_mapping_type": "string",
              "match": "*date*",
              "mapping": {
                "type": "date",
                "format": "yyyy-MM-dd HH:mm:ss||yyyy-MM-dd||epoch_millis"
              }
            }
          }
        ]
      }
    }
  }
}

关键说明 #

• dynamic_templates会优先于ES默认的动态映射生效，能精准控制动态字段的类型转换
• 可通过match/unmatch匹配字段名模式，或match_mapping_type匹配值的原始类型来制定规则
• 如果需要更灵活的内容识别，也可以结合pattern正则匹配字段值的格式（比如匹配符合日期格式的字符串）

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