Spring Cloud微服务项目CassandraClusterFactoryBean找不到符号求助

问题根源 #

Spring Boot 2.7.5 对应的 Spring Data Cassandra 版本（4.x）已经移除了CassandraClusterFactoryBean，这个类属于旧版 DataStax Java Driver 3.x 的适配类，新版驱动4.x改用CqlSessionFactoryBean作为会话工厂实现，同时API结构也有较大调整。另外你的pom.xml还存在Java版本不一致的问题（properties声明17，编译插件配置19），也可能引发编译异常。

解决方案 #

1. 修正Maven依赖与Java版本配置 #

替换直接引入的spring-data-cassandra为Spring Boot官方starter，同时统一Java编译版本：

修改后的pom.xml关键部分：

<properties>
   <java.version>17</java.version>
</properties>
<dependencies>
   <!-- 替换原spring-data-cassandra为starter -->
   <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-data-cassandra</artifactId>
   </dependency>
   <!-- 其他依赖保留 -->
   <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-web</artifactId>
   </dependency>
   <dependency>
      <groupId>com.codahale.metrics</groupId>
      <artifactId>metrics-core</artifactId>
      <version>3.0.2</version>
   </dependency>
   <dependency>
      <groupId>org.projectlombok</groupId>
      <artifactId>lombok</artifactId>
      <optional>true</optional>
   </dependency>
   <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-test</artifactId>
      <scope>test</scope>
   </dependency>
</dependencies>

<build>
   <plugins>
      <plugin>
         <groupId>org.springframework.boot</groupId>
         <artifactId>spring-boot-maven-plugin</artifactId>
      </plugin>
      <plugin>
         <groupId>org.apache.maven.plugins</groupId>
         <artifactId>maven-compiler-plugin</artifactId>
         <configuration>
            <!-- 统一为properties中声明的Java 17 -->
            <source>17</source>
            <target>17</target>
         </configuration>
      </plugin>
   </plugins>
</build>

2. 替换配置类中的旧API #

将原有的CassandraClusterFactoryBean替换为新版的CqlSessionFactoryBean，并适配驱动4.x的配置方式：

修改后的配置类代码：

import org.springframework.data.cassandra.config.AbstractCassandraConfiguration;
import org.springframework.data.cassandra.config.CqlSessionFactoryBean;
import com.datastax.oss.driver.api.core.CqlSessionBuilder;

public class CassandraConfiguration extends AbstractCassandraConfiguration {

    // 假设username和password是已注入的配置属性
    private String username;
    private String password;

    @Override
    public CqlSessionFactoryBean session() {
        CqlSessionFactoryBean sessionFactoryBean = super.session();
        // 配置用户名密码，适配驱动4.x的SessionBuilder
        sessionFactoryBean.setSessionBuilderConfigurer(sessionBuilder -> 
            sessionBuilder.withAuthCredentials(username, password)
        );
        return sessionFactoryBean;
    }

    // 必须实现的抽象方法：指定Cassandra键空间名称
    @Override
    protected String getKeyspaceName() {
        return "your_keyspace_name"; // 替换为你的实际键空间名称
    }
}

3. 验证修复 #

执行以下步骤确保生效：

• 执行mvn clean install清理并重新构建项目
• 在IDEA/Eclipse中刷新Maven依赖（IDEA点击右侧Maven面板刷新按钮，Eclipse右键项目→Maven→Update Project）
• 重新编译项目，确认编译错误消失

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