更新依赖后为何出现JDK类java.lang.NoClassDefFoundError异常？

问题描述 #

更新某依赖版本后，程序抛出java.lang.NoClassDefFoundError: javax/net/ssl/SSLSession异常。javax.net.ssl.SSLSession是JDK自带rt.jar中的核心类，疑惑为何依赖更新会导致JDK核心类无法被加载。

编辑：后续排查确认，这类依赖变更本身不会引发该问题，当时未知的基础镜像变更才是真正诱因。保留此问题，希望相关内容能帮助遇到类似问题的开发者，建议优先检查类路径配置和JDK目录完整性。

排查与解决建议 #

• 确认JDK环境完整性：检查运行环境的JDK目录是否完整，基础镜像变更可能替换了JDK版本或损坏了rt.jar等核心文件，导致系统类加载器无法找到目标类。
• 验证类路径配置：查看程序启动时的-classpath/-cp参数，是否存在自定义类路径覆盖系统默认JDK类路径的情况，部分构建工具或插件可能意外修改了类加载优先级。
• 分析依赖冲突：虽然依赖更新不会直接导致JDK类丢失，但个别依赖可能包含javax.net.ssl包下的自定义类，干扰系统类加载器的查找逻辑。可通过构建工具命令分析依赖树，比如Maven的mvn dependency:tree或Gradle的gradle dependencies。
• 检查容器部署配置：如果是容器化运行，确认基础镜像的JDK安装步骤是否正确，是否存在镜像构建过程中误删除JDK核心文件的操作。

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