Spring Boot3中springdoc-openapi-ui与swagger-parser共存引发类找不到异常

问题原因 #

1. Spring Boot 3.x基于Java 17，JDK已移除了javax.xml.bind（JAXB）相关核心模块，而旧版本的swagger-parser依赖该模块实现XML解析。
2. springdoc-openapi会自动扫描类路径中的OpenAPI相关组件，当检测到swagger-parser存在时，会触发其内部的解析逻辑，间接调用到依赖javax.xml.bind.annotation.XmlElement的代码，最终抛出ClassNotFoundException。

解决办法 #

方案1：升级swagger-parser到Java 17兼容版本

这是最稳妥的方案，新版本的swagger-parser已经适配Jakarta EE规范，移除了对javax.xml.bind的依赖。在Gradle中更新依赖：

implementation 'io.swagger.parser.v3:swagger-parser:2.2.10' // 或更高兼容版本

升级后，swagger-parser会使用jakarta.xml.bind替代旧的javax.xml.bind，与Spring Boot 3.x的依赖体系兼容。

方案2：通过类路径隔离实现二者共存

如果无法升级swagger-parser版本，可以用Gradle的Shadow插件将swagger-parser及其依赖打包到独立的命名空间，避免与springdoc-openapi的类路径冲突：

plugins {
    id 'com.github.johnrengelman.shadow' version '8.1.1'
}

shadowJar {
    // 将swagger-parser的类重定位到自定义包名
    relocate 'io.swagger.parser', 'com.yourcompany.swagger.parser.isolated'
    // 同时重定位JAXB相关类
    relocate 'javax.xml.bind', 'com.yourcompany.jaxb.isolated'
}

业务逻辑中直接引用Shadow包中的隔离类，springdoc-openapi的类路径中不会扫描到这些重定位后的类，自然不会触发冲突逻辑。

方案3：替换JAXB依赖（兼容性风险较高）

如果必须保留旧版本swagger-parser，可以排除其依赖的旧JAXB模块，手动添加Jakarta版本的JAXB替代：

implementation('io.swagger.parser.v3:swagger-parser:你的旧版本') {
    exclude group: 'javax.xml.bind', module: 'jaxb-api'
}
// 添加Jakarta版本的JAXB API和运行时
implementation 'jakarta.xml.bind:jakarta.xml.bind-api:4.0.0'
implementation 'org.glassfish.jaxb:jaxb-runtime:4.0.2'

注意：这种方式可能存在潜在的兼容性问题，仅在无法升级swagger-parser时临时使用。

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