Spring Boot 2.4.5下Elasticsearch客户端与集群版本不匹配问题修复咨询

问题根源 #

你当前使用的Spring Boot 2.4.5默认绑定Spring Data Elasticsearch 4.1.8，该版本依赖Elasticsearch 7.9.x系列客户端。即便手动引入了7.17.3的elasticsearch-java，Gradle的依赖解析逻辑会优先采用Spring Boot依赖管理中指定的旧版本，导致实际运行的客户端为7.9.3。而你的Elasticsearch集群是8.6.1，版本差距过大触发兼容性警告，甚至可能引发API不兼容、数据读写异常。

解决方案 #

方案1：强制覆盖Elasticsearch客户端版本（不升级Spring Boot） #

在Gradle配置中，覆盖Spring Boot的依赖管理，强制指定兼容8.x集群的Elasticsearch版本为7.17.3（官方确认7.17.x是唯一兼容8.x集群的7.x版本）：

ext {
    // 覆盖Spring Boot默认的Elasticsearch版本
    set('elasticsearch.version', '7.17.3')
}

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-data-elasticsearch'
    // 若需使用新的Elasticsearch Java Client，确保版本与上述一致
    implementation 'co.elastic.clients:elasticsearch-java:7.17.3'
    // 可选：确保Jackson版本与Elasticsearch兼容（7.17.3依赖Jackson 2.12.x）
    implementation 'com.fasterxml.jackson.core:jackson-databind:2.12.7'
}

如果上述方式未生效，可直接排除starter中的旧客户端依赖，手动引入完整的兼容版本：

dependencies {
    implementation('org.springframework.boot:spring-boot-starter-data-elasticsearch') {
        exclude group: 'org.elasticsearch', module: 'elasticsearch'
        exclude group: 'org.elasticsearch.client', module: 'elasticsearch-rest-client'
        exclude group: 'org.elasticsearch.client', module: 'elasticsearch-rest-high-level-client'
    }
    // 引入兼容8.x集群的7.17.3版本依赖
    implementation 'org.elasticsearch:elasticsearch:7.17.3'
    implementation 'org.elasticsearch.client:elasticsearch-rest-client:7.17.3'
    implementation 'org.elasticsearch.client:elasticsearch-rest-high-level-client:7.17.3'
    implementation 'co.elastic.clients:elasticsearch-java:7.17.3'
    implementation 'com.fasterxml.jackson.core:jackson-databind:2.12.7'
}

方案2：升级Spring Boot版本（推荐，彻底解决兼容性） #

Spring Boot 2.4.5属于较旧版本，建议升级到长期支持（LTS）版本或匹配集群版本的Spring Boot：

• 升级到Spring Boot 2.7.x（LTS）：对应Spring Data Elasticsearch 4.4.x，原生支持Elasticsearch 7.17.x，无需大量手动配置，同时兼容8.x集群。修改Gradle插件版本：

plugins {
    id 'org.springframework.boot' version '2.7.15'
    id 'io.spring.dependency-management' version '1.0.15.RELEASE'
    id 'java'
}

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-data-elasticsearch'
    implementation 'co.elastic.clients:elasticsearch-java:7.17.3'
}

• 升级到Spring Boot 3.x：对应Spring Data Elasticsearch 5.x，原生支持Elasticsearch 8.x系列客户端，与你的8.6.1集群版本完全匹配，无需额外引入elasticsearch-java（starter已集成）：

plugins {
    id 'org.springframework.boot' version '3.2.0'
    id 'io.spring.dependency-management' version '1.1.4'
    id 'java'
}

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-data-elasticsearch'
}

验证步骤 #

1. 执行./gradlew dependencies命令，检查elasticsearch相关依赖的版本是否为7.17.3（或8.6.x，若升级Spring Boot 3.x）。
2. 重启应用，查看启动日志，确认客户端版本与集群版本的兼容性警告消失。

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