构建DataStax Cassandra 4.14项目遇NoClassDefFoundError求助

问题分析 #

编译时抛出java.lang.NoClassDefFoundError: com/datastax/oss/driver/api/mapper/entity/naming/GetterStyle，核心原因是注解处理器java-driver-mapper-processor运行时classpath缺失必要依赖模块，或DataStax驱动相关组件版本不统一。

解决方案 #

1. 统一DataStax驱动版本 #

首先确认gradle.properties中版本变量配置正确，保证注解处理器与运行时依赖版本完全一致：

cassandraSdkVersion=4.14.0
lombokVersion=1.18.24

2. 完善注解处理器依赖 #

GetterStyle类属于java-driver-mapper-runtime模块，需要将其加入注解处理器的classpath中，修改Gradle依赖配置：

dependencies {
    // ... 其他业务依赖

    // Cassandra相关配置
    annotationProcessor group: 'org.projectlombok', name: 'lombok', version: lombokVersion
    // 新增mapper-runtime到注解处理器依赖
    annotationProcessor group: 'com.datastax.oss', name: 'java-driver-mapper-runtime', version: cassandraSdkVersion
    annotationProcessor group: 'com.datastax.oss', name: 'java-driver-mapper-processor', version: cassandraSdkVersion

    implementation "com.datastax.oss:java-driver-mapper-runtime:${cassandraSdkVersion}"
    implementation "com.datastax.oss:java-driver-core:${cassandraSdkVersion}"
    implementation "com.datastax.oss:java-driver-query-builder:${cassandraSdkVersion}"
    compileOnly group: 'org.projectlombok', name: 'lombok', version: lombokVersion
    // 移除手动强制的native-protocol依赖，让驱动自行管理版本避免冲突
    // implementation "com.datastax.oss:native-protocol:1.5.1"

    // ... 其他业务依赖
}

3. 覆盖Spring Boot默认驱动版本 #

Spring Boot 2.3.5.RELEASE默认绑定的DataStax驱动版本为3.x，会与你使用的4.14.0冲突，添加依赖管理块强制统一版本：

dependencyManagement {
    imports {
        mavenBom "com.datastax.oss:java-driver-bom:${cassandraSdkVersion}"
    }
}

4. 修正Mapper类构建逻辑 #

原Mapper静态构建方法写法错误，需使用驱动自动生成的Builder类：

import com.datastax.oss.driver.api.mapper.annotations.Mapper;
import com.datastax.oss.driver.api.mapper.annotations.DaoFactory;
import com.datastax.oss.driver.api.mapper.annotations.DaoKeyspace;
import com.datastax.oss.driver.api.mapper.annotations.DaoTable;
import com.datastax.oss.driver.api.mapper.annotations.Dao;
import com.datastax.oss.driver.api.core.CqlSession;

@Mapper
public interface CassandraMapper {

    static CassandraMapper build(CqlSession session) {
        // 使用驱动生成的Builder类构建实例
        return CassandraMapper.builder(session).build();
    }

    @DaoFactory
    ExampleDao exampleDao(@DaoKeyspace String keyspace, @DaoTable String table);
}

验证执行 #

清理并重新编译项目：

./gradlew clean compileJava

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