Spring Boot 3.x中Spring Data Couchbase Repository无法正常工作

问题原因 #

Spring Boot 3.x（如3.0.5）对应的Spring Data Couchbase版本依赖Couchbase Java SDK 3.4+，CoreQueryOptions是该SDK核心包中的类。报错本质是依赖版本不兼容或缺失：

• 手动指定spring-webmvc版本（6.0.9）破坏了Spring Boot父依赖的版本一致性，导致Spring Data Couchbase与Spring框架的依赖树冲突，间接引发Couchbase SDK核心类无法加载。
• Spring Boot 2.7.x与3.x的依赖体系差异较大，直接迁移时未同步适配依赖管理规则。

解决方案 #

1. 修复POM依赖，移除手动指定的spring-webmvc #

Spring Boot的spring-boot-starter-web已内置适配当前Boot版本的spring-webmvc，手动指定版本会导致依赖冲突。修改后的POM如下：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.0.5</version>
    </parent>

    <groupId>com.example.librarymgt</groupId>
    <artifactId>org_libmgt_v1_svc</artifactId>
    <version>1.0.0</version>
    <packaging>jar</packaging>
    <name>org_libmgt_v1_svc</name>

    <properties>
        <java.version>17</java.version>
    </properties>

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

2. 确保Couchbase配置类适配Spring Boot 3.x #

检查CouchbaseConfig是否正确实现AbstractCouchbaseConfiguration的必要方法，示例实现如下：

@Configuration
@EnableCouchbaseRepositories(basePackages = {"org.libmgt.repository"})
public class CouchbaseConfig extends AbstractCouchbaseConfiguration {

    @Value("${spring.couchbase.connection-string}")
    private String connectionString;

    @Value("${spring.couchbase.username}")
    private String username;

    @Value("${spring.couchbase.password}")
    private String password;

    @Value("${spring.couchbase.bucket-name}")
    private String bucketName;

    @Override
    public String getConnectionString() {
        return connectionString;
    }

    @Override
    public String getUserName() {
        return username;
    }

    @Override
    public String getPassword() {
        return password;
    }

    @Override
    public String getBucketName() {
        return bucketName;
    }
}

3. 刷新依赖并清理构建缓存 #

执行以下Maven命令，确保依赖完全重新下载，避免缓存的旧版本干扰：

mvn clean install -U

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