Spring Boot 3.2.2集成Couchbase Java Client 2.7：连接建立后随即断开

核心原因：版本严重不兼容 #

你使用的spring-data-couchbase 3.2.12.RELEASE是适配Spring Boot 2.x的版本，而当前Spring Boot 3.2.2基于Spring Framework 6.x，两者依赖体系完全不匹配。错误中的org/springframework/data/convert/EntityInstantiators类，在Spring Boot 3.x对应的Spring Data版本中要么包路径变更，要么类结构调整，旧版spring-data-couchbase无法找到该类，进而导致初始化失败。

同时，Couchbase Java Client 2.7.18是停止维护多年的老旧版本，本身也不兼容Spring Boot 3.x环境。

解决方案 #

方案1：使用Spring Boot官方依赖管理自动匹配版本 #

移除手动指定的版本号，让Spring Boot依赖管理自动引入兼容的组件版本，这是最稳妥的方式：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-couchbase</artifactId>
</dependency>

该starter会自动引入与Spring Boot 3.2.2完全兼容的spring-data-couchbase（对应2023.0.x版本）和Couchbase Java Client 3.x版本，彻底解决版本冲突问题。

方案2：手动指定兼容版本（不推荐） #

如果必须手动控制版本，需确保spring-data-couchbase版本与Spring Boot 3.2.2的Spring Data版本对齐：

• Spring Boot 3.2.2对应的Spring Data版本为2023.0.2（代号Ullrich SR2）
• 对应spring-data-couchbase版本为5.2.2
• 搭配Couchbase Java Client 3.4.x及以上兼容版本

依赖示例：

<dependency>
    <groupId>org.springframework.data</groupId>
    <artifactId>spring-data-couchbase</artifactId>
    <version>5.2.2</version>
</dependency>
<dependency>
    <groupId>com.couchbase.client</groupId>
    <artifactId>java-client</artifactId>
    <version>3.4.12</version>
</dependency>

额外注意事项 #

• 升级Couchbase客户端后，需检查配置文件中的连接参数：3.x客户端配置项与2.x有差异，比如用spring.couchbase.connection-string替代旧版的spring.couchbase.bootstrap-hosts
• 确保Couchbase Server版本与客户端版本兼容（3.x客户端支持Couchbase Server 6.5及以上）

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