Spring Boot 2.7.2升级后Actuator /actuator/health报错求助

问题本质 #

报错java.lang.IncompatibleClassChangeError: 发现com.couchbase.client.java.Cluster接口，但预期为类，核心原因是Couchbase Java客户端版本与Spring Boot 2.7.2的依赖体系不兼容：

• Spring Boot 1.4.0默认依赖Couchbase Client 2.x，此版本中Cluster是类；
• Spring Boot 2.7.x默认依赖Couchbase Client 3.x，该版本将Cluster重构为接口；
• Actuator的Couchbase健康检查组件按旧版本的类逻辑调用，触发类型不匹配错误。

修复方案 #

1. 统一依赖版本，用Spring Boot依赖管理接管 #

在build.gradle中确保使用Spring Boot的依赖管理机制，自动对齐兼容的Couchbase Client版本，删除手动指定的旧版本依赖：

plugins {
    id 'org.springframework.boot' version '2.7.2'
    id 'io.spring.dependency-management' version '1.0.13.RELEASE'
}

dependencies {
    // 仅引入Spring Boot提供的Couchbase starter，依赖管理自动拉取兼容的3.x版本
    implementation 'org.springframework.boot:spring-boot-starter-data-couchbase'
    // 移除旧的硬编码版本依赖，比如：
    // implementation 'com.couchbase.client:java-client:2.xxx'
}

2. 排查并排除冲突依赖 #

执行Gradle命令查看依赖树，确认是否有第三方依赖间接引入Couchbase 2.x版本：

./gradlew dependencies --configuration compileClasspath | grep couchbase

如果发现2.x版本的依赖，在对应的依赖声明中排除：

implementation('第三方依赖坐标') {
    exclude group: 'com.couchbase.client', module: 'java-client'
}

3. 适配自定义Couchbase代码（如有） #

如果项目中存在自定义的Couchbase连接或健康检查逻辑，需要适配3.x版本的API：

• 旧2.x写法：Cluster cluster = CouchbaseCluster.create("host");
• 新3.x写法：Cluster cluster = Cluster.connect("host", "username", "password");

验证步骤 #

1. 执行./gradlew clean build清理构建项目
2. 启动应用后访问/actuator/health，确认报错消失
3. 验证Couchbase相关业务功能正常运行

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