升级Dropwizard至4.0.1后运行时缺失javax类的排查求助

Dropwizard 4.0.x 彻底切换到了 Jakarta EE 9+ 规范，所有原有的javax.*命名空间全换成了jakarta.*。你遇到的NoClassDefFoundError，本质是应用或依赖链里还有组件在尝试加载旧的Java EE版本JAX-RS类（javax.ws.rs.core.HttpHeaders），而Dropwizard 4.x只提供Jakarta版本的API（jakarta.ws.rs.core.HttpHeaders）。

下面是具体的排查和解决步骤：

1. 揪出偷偷引入javax.ws.rs的依赖 #

就算你手动排除了部分javax依赖，难保第三方库或Dropwizard扩展还在偷偷拉旧的JAX-RS API。跑下面的命令生成依赖树，专门找javax.ws.rs相关的依赖：

mvn dependency:tree -Dincludes=javax.ws.rs:*

如果输出里有javax.ws.rs:javax.ws.rs-api这类条目，找到对应的父依赖，在pom里显式排除它：

<dependency>
    <!-- 替换成实际引入旧依赖的库 -->
    <groupId>com.example</groupId>
    <artifactId>some-third-party-lib</artifactId>
    <exclusions>
        <exclusion>
            <groupId>javax.ws.rs</groupId>
            <artifactId>javax.ws.rs-api</artifactId>
        </exclusion>
    </exclusions>
</dependency>

2. 检查代码里的隐式引用 #

你可能已经删了显式的javax导入，但还有几种隐式情况容易漏：

• 反射调用：全局搜代码里的"javax.ws.rs"字符串，看有没有用反射加载旧类的情况；
• 配置文件：比如config.yml里有没有写旧API类的全类名（比如自定义的Provider、Filter）；
• 注解处理器生成的代码：比如Dagger自动生成的class文件，偶尔会带javax引用，去target目录里搜下相关类确认。

3. 确认Dropwizard依赖版本对齐 #

一定要用Dropwizard 4.x的BOM来管理依赖版本，避免出现混合javax和jakarta的情况。在pom的dependencyManagement里加上：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>io.dropwizard</groupId>
            <artifactId>dropwizard-bom</artifactId>
            <version>4.0.1</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

这样所有Dropwizard相关的依赖都会自动用兼容的Jakarta版本。

4. 定位类加载来源 #

如果上面的方法没找到问题，用Java的类加载日志来定位到底是哪个JAR在加载这个旧类。启动应用时加这个参数：

java -verbose:class -jar your-app.jar | grep "javax.ws.rs.core.HttpHeaders"

输出会显示加载这个类的JAR路径，直接找到根源处理。

5. 处理Dagger的javax.inject #

虽然javax.inject和JAX-RS的包不冲突，但如果项目里同时存在Jakarta的jakarta.inject和旧的javax.inject，可能引发类加载混淆。建议把Dagger升级到2.40+（这个版本开始支持Jakarta注入），然后替换依赖：

<dependency>
    <groupId>jakarta.inject</groupId>
    <artifactId>jakarta.inject-api</artifactId>
</dependency>

同时把代码里的import javax.inject.*;全改成import jakarta.inject.*;。

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