Spring Data Cassandra 4.0.5多键空间连接报错：cassandraTemplate Bean创建失败

报错信息：

Error creating bean with name 'cassandraTemplate' defined in class path resource \
  [learn/multiple/database/configuration/SerenoKeyspaceConfig.class]: \
  No matching factory method found on class [learn.multiple.database.configuration.SerenoKeyspaceConfig]: \
  factory bean 'serenoKeyspaceConfig'; factory method 'cassandraTemplate()'. \
  Check that a method with the specified name exists and that it is non-static.

问题原因 #

Spring Data Cassandra 4.0.x（对应Spring Boot 2.6+）相较于3.3.x版本，在CassandraTemplate的Bean创建逻辑上有兼容性变更：

• 旧版本允许无参的cassandraTemplate()工厂方法，但新版本要求该方法必须依赖Session或CassandraSessionFactoryBean等核心实例，无参方法无法满足框架的依赖注入要求。
• 若配置类未继承AbstractCassandraConfiguration，新版本框架无法自动关联创建CassandraTemplate所需的底层资源，导致找不到匹配的工厂方法。
• 多Keyspace配置场景下，旧版本的Bean隔离方式在新版本中不再生效，需要显式区分不同配置的Bean实例。

解决方案 #

方案1：修正cassandraTemplate方法的签名，传入必要依赖 #

确保配置类中创建CassandraTemplate时注入Session实例，示例代码：

@Configuration
public class SerenoKeyspaceConfig {

    @Bean
    public CassandraSessionFactoryBean serenoSession() {
        CassandraSessionFactoryBean session = new CassandraSessionFactoryBean();
        session.setContactPoints("你的Cassandra地址");
        session.setPort(9042);
        session.setKeyspaceName("sereno");
        // 按需配置集群、映射上下文等其他参数
        return session;
    }

    @Bean
    public CassandraTemplate cassandraTemplate(Session serenoSession) {
        return new CassandraTemplate(serenoSession);
    }
}

方案2：让配置类继承AbstractCassandraConfiguration #

继承框架提供的抽象配置类，复用底层资源创建逻辑，示例：

@Configuration
public class SerenoKeyspaceConfig extends AbstractCassandraConfiguration {

    @Override
    protected String getKeyspaceName() {
        return "sereno";
    }

    @Override
    protected String getContactPoints() {
        return "你的Cassandra地址";
    }

    @Override
    protected int getPort() {
        return 9042;
    }

    // 如需自定义CassandraTemplate，可覆盖此方法
    @Override
    @Bean
    public CassandraTemplate cassandraTemplate() throws Exception {
        return new CassandraTemplate(session().getObject());
    }
}

方案3：多Keyspace场景下显式区分Bean #

如果是多Keyspace配置，需通过名称或限定符隔离不同的CassandraTemplate实例：

@Configuration
public class SerenoKeyspaceConfig extends AbstractCassandraConfiguration {

    @Override
    protected String getKeyspaceName() {
        return "sereno";
    }

    // 其他Keyspace配置...

    @Bean("serenoCassandraTemplate")
    public CassandraTemplate serenoCassandraTemplate() throws Exception {
        return new CassandraTemplate(session().getObject());
    }
}

使用时通过@Qualifier("serenoCassandraTemplate")注入对应实例。

补充检查 #

• 确保cassandraTemplate()方法为非静态且public权限，Spring需要访问该方法创建Bean。
• 清理项目中废弃的依赖配置，避免新旧版本配置逻辑冲突。

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