Spring Boot集成Cassandra报错：无法加载GetterStyle类

问题根源 #

com.datastax.oss.driver.api.mapper.entity.naming.GetterStyle是Cassandra Java驱动映射器（mapper）模块的核心类，出现类找不到的问题，大概率是依赖中缺失了mapper相关包，或是Spring Boot的依赖管理与你指定的驱动版本冲突。另外MapStruct作为编译期生成工具，和Cassandra mapper的注解处理器配置也可能存在衔接问题。

具体修复步骤 #

1. 补全Cassandra Mapper依赖 #

在Gradle构建文件中必须添加mapper的运行时包和编译期注解处理器包，这是解决类找不到的核心：

dependencies {
    // Cassandra核心驱动
    implementation 'com.datastax.oss:java-driver-core:4.14.1'
    // 关键：mapper运行时依赖，缺失此包会直接报类找不到
    implementation 'com.datastax.oss:java-driver-mapper-runtime:4.14.1'
    // 编译期生成mapper实现类的注解处理器
    annotationProcessor 'com.datastax.oss:java-driver-mapper-processor:4.14.1'

    // 你的其他项目依赖
    implementation 'org.springframework.boot:spring-boot-starter-data-cassandra'
    implementation 'org.mapstruct:mapstruct:1.4.2.Final'
    annotationProcessor 'org.mapstruct:mapstruct-processor:1.4.2.Final'
}

2. 锁定驱动版本避免Spring Boot依赖冲突 #

Spring Boot 2.3.12.RELEASE自带的Cassandra驱动版本可能与你指定的4.14.1不一致，通过BOM统一锁定版本，避免依赖冲突：

dependencyManagement {
    imports {
        mavenBom "org.springframework.boot:spring-boot-dependencies:2.3.12.RELEASE"
        // 覆盖Spring Boot默认的驱动版本，保证所有Cassandra模块版本统一
        mavenBom "com.datastax.oss:java-driver-bom:4.14.1"
    }
}

3. 调整编译期处理器配置 #

MapStruct和Cassandra mapper都是编译期注解处理器，将它们放在同一配置块中，避免编译顺序导致的生成失败：

annotationProcessor 'com.datastax.oss:java-driver-mapper-processor:4.14.1'
annotationProcessor 'org.mapstruct:mapstruct-processor:1.4.2.Final'
// 若项目使用Lombok，需同时添加其注解处理器，避免与MapStruct冲突
// annotationProcessor 'org.projectlombok:lombok:1.18.20'

4. 清理并重新构建项目 #

清除旧的编译产物后重新构建，确保mapper的实现类能正确生成：

./gradlew clean build

验证要点 #

• 执行依赖树命令，确认java-driver-mapper-runtime已被正确引入：

./gradlew dependencies

• 查看编译后的目录（通常为build/classes/java/main），确认是否生成了类似TestTableMapperImpl的实现类，存在则说明mapper处理器工作正常。

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