整合ShardingSphere与JPA时如何解决‘JAXB-API implementation not found’错误

我之前在把ShardingSphere和Spring Data JPA整合做分表的时候，也踩过这个JAXB-API找不到的坑，看你的错误堆栈，核心原因其实很明确：从Java 9开始，JAXB不再是JDK的默认内置模块了，而ShardingSphere在解析YAML配置或者处理部分数据库交互逻辑时，需要用到JAXB的具体实现，所以启动时才会报这个类路径找不到的错误。

给你几个直接有效的解决办法：

1. 手动引入JAXB依赖包 #

根据你的构建工具，把对应的依赖加到项目里就行：

Maven 配置 #

<dependencies>
    <!-- Spring Boot 3.x / Java 17+ 用这套Jakarta规范的依赖 -->
    <dependency>
        <groupId>jakarta.xml.bind</groupId>
        <artifactId>jakarta.xml.bind-api</artifactId>
        <version>4.0.2</version>
    </dependency>
    <dependency>
        <groupId>org.glassfish.jaxb</groupId>
        <artifactId>jaxb-runtime</artifactId>
        <version>4.0.4</version>
        <scope>runtime</scope>
    </dependency>

    <!-- Spring Boot 2.x / Java 8-11 用这套Javax规范的依赖 -->
    <!-- <dependency>
        <groupId>javax.xml.bind</groupId>
        <artifactId>jaxb-api</artifactId>
        <version>2.3.1</version>
    </dependency>
    <dependency>
        <groupId>com.sun.xml.bind</groupId>
        <artifactId>jaxb-impl</artifactId>
        <version>2.3.1</version>
        <scope>runtime</scope>
    </dependency> -->
</dependencies>

Gradle 配置 #

dependencies {
    // Spring Boot 3.x / Java 17+ 依赖
    implementation 'jakarta.xml.bind:jakarta.xml.bind-api:4.0.2'
    runtimeOnly 'org.glassfish.jaxb:jaxb-runtime:4.0.4'

    // Spring Boot 2.x / Java 8-11 依赖
    // implementation 'javax.xml.bind:jaxb-api:2.3.1'
    // runtimeOnly 'com.sun.xml.bind:jaxb-impl:2.3.1'
}

2. 检查版本兼容性 #

• 如果你用的是Spring Boot 3.x，必须使用jakarta.*前缀的JAXB依赖；Spring Boot 2.x则对应javax.*的依赖，版本不匹配很容易导致奇怪的类找不到问题。
• 同时确保ShardingSphere版本和Spring Boot适配：比如ShardingSphere 5.4.x+适配Spring Boot 3.x，5.3.x系列适配Spring Boot 2.x。

3. 额外排查点 #

如果加了依赖还是报错，可以再检查这两点：

• 确认ShardingSphere的YAML配置没有语法错误，比如分表规则、数据源配置是否符合格式要求，配置文件的解析错误也可能触发类似的依赖异常；
• 清理项目依赖缓存，比如Maven执行mvn clean install -U，Gradle执行./gradlew clean build --refresh-dependencies，避免缓存的旧依赖或冲突依赖影响。

我当时就是加了JAXB的runtime依赖后，服务直接启动成功了，你可以试试这个方案。

内容来源于stack exchange