ElasticSearch 8.0.1新版Java API创建带mapping索引mapping不生效问题

你遇到的mapping不生效问题核心是反序列化时传入的JSON结构和反序列化器预期结构不匹配：

1. 你当前使用TypeMapping._DESERIALIZER反序列化读取整个mapping文件内容，但你的JSON文件根节点同时包含settings和mappings两个顶层字段，是完整的创建索引请求结构，不是纯TypeMapping结构。
2. TypeMapping._DESERIALIZER预期接收的JSON根节点直接是mappings字段对应的内容（即包含properties的那层对象），它解析你传入的完整JSON时找不到匹配的结构，直接返回null。
3. Elasticsearch Java客户端对传入的null值mapping参数默认做忽略处理，不会抛出异常，因此最终创建出的索引没有自定义mapping配置。
4. Postman请求能正常生效是因为你把完整JSON直接发给了ES服务端接口，服务端会自行识别解析settings、mappings字段，不存在客户端反序列化结构不匹配的问题。

另外你当前的写法还遗漏了settings配置的加载，就算单独把mappings解析正确，自定义分词器my_analyzer因为没有随请求创建，后续写入数据时也会报分词器不存在的错误。

二选一即可，推荐优先用方案1，代码更简洁不需要手动拆分JSON。

方案1：直接反序列化整个创建索引请求对象 #

直接用CreateIndexRequest对应的反序列化器读取整个JSON文件，不需要手动拆分settings和mappings：

final RestClient restClient = RestClient
        .builder(new HttpHost(hostName, port, "https"))
        .setHttpClientConfigCallback(httpClientBuilder -> httpClientBuilder.setDefaultCredentialsProvider(provider))
        .build();

final ElasticsearchTransport transport = new RestClientTransport(restClient, new JacksonJsonpMapper());
final ElasticsearchClient client = new ElasticsearchClient(transport);
final JsonpMapper mapper = client._transport().jsonpMapper();

// 用try-with-resources自动关闭parser，避免资源泄漏
try (JsonParser parser = mapper.jsonProvider().createParser(
        new StringReader(Files.readString(Paths.get(mappingFile), StandardCharsets.UTF_8))
)) {
    CreateIndexRequest request = CreateIndexRequest._DESERIALIZER.deserialize(parser, mapper);
    // 手动指定索引名，避免JSON中硬编码索引名和业务参数冲突
    request.index(indexName);
    client.indices().create(request);
}

方案2：手动拆分JSON节点分别反序列化 #

如果需要灵活调整配置项，可以先把JSON文件解析为通用树结构，分别取出settings、mappings节点单独反序列化后组装请求：

final RestClient restClient = RestClient
        .builder(new HttpHost(hostName, port, "https"))
        .setHttpClientConfigCallback(httpClientBuilder -> httpClientBuilder.setDefaultCredentialsProvider(provider))
        .build();

final ElasticsearchTransport transport = new RestClientTransport(restClient, new JacksonJsonpMapper());
final ElasticsearchClient client = new ElasticsearchClient(transport);
final JsonpMapper mapper = client._transport().jsonpMapper();
ObjectMapper objectMapper = new ObjectMapper();

// 读取整个JSON文件
JsonNode rootNode = objectMapper.readTree(Files.readString(Paths.get(mappingFile), StandardCharsets.UTF_8));

// 反序列化settings配置
JsonNode settingsNode = rootNode.get("settings");
try (JsonParser settingsParser = mapper.jsonProvider().createParser(
        new StringReader(objectMapper.writeValueAsString(settingsNode))
)) {
    IndexSettings indexSettings = IndexSettings._DESERIALIZER.deserialize(settingsParser, mapper);

    // 反序列化mappings配置
    JsonNode mappingsNode = rootNode.get("mappings");
    try (JsonParser mappingsParser = mapper.jsonProvider().createParser(
            new StringReader(objectMapper.writeValueAsString(mappingsNode))
    )) {
        TypeMapping typeMapping = TypeMapping._DESERIALIZER.deserialize(mappingsParser, mapper);

        // 组装创建索引请求
        client.indices().create(req -> req
                .index(indexName)
                .settings(indexSettings)
                .mappings(typeMapping)
        );
    }
}

• 所有ES客户端内置的_DESERIALIZER都严格要求传入的JSON结构和目标类型匹配，比如TypeMapping._DESERIALIZER不能接收外层套了mappings键的JSON，也不能混入其他同级字段。
• 所有JsonParser实例必须手动关闭，推荐统一用try-with-resources语法自动管理资源，避免内存泄漏。
• 如果使用方案1，不要在JSON文件中硬编码index字段，统一在代码中传入索引名，避免多环境下配置冲突。

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