NoClassDefFoundError在OpenJDK中多因com.sun.或sun.私有API被移除所致，需改用javax.imageio等标准API、升级第三方库、检查模块路径与依赖传递一致性。
OpenJDK 报 NoClassDefFoundError，绝大多数情况不是代码写错了，而是类在编译期存在、运行期“消失”或“不可见”了——尤其是当你从 Oracle JDK 切到 OpenJDK 后首次遇到这个错，大概率是碰上了 com.sun.* 或 sun.* 包的兼容性断层。
确认是不是 OpenJDK 特有类缺失（比如 com.sun.image.codec.jpeg）
OpenJDK 从 9 开始彻底移除了 rt.jar 中大量 sun.* 和 com.sun.* 的内部 API，包括图像编解码、JNDI 工具类等。如果你的堆栈里出现类似 NoClassDefFoundError: com/sun/image/codec/jpeg/ImageFormatException，基本可以锁定是调用了已废弃的私有 API。
- 不要试图把 Oracle JDK 的
rt.jar手动塞进 OpenJDK 类路径——体积大、不安全、违反模块化原则 - 改用标准替代方案：例如用
javax.imageio.ImageIO替代JPEGCodec；用java.util.Base64替代sun.misc.BASE64Encoder - 检查第三方依赖（如旧版
jcaptcha、itext、某些国产中间件 SDK），它们可能硬编码引用了这些内部类；升级到支持 OpenJDK 的版本（如jcaptcha-all-1.0-RC6.jar）
检查模块路径（--module-path）和类路径（-cp）是否混用
OpenJDK 9+ 默认启用模块系统，-cp 和 --module-path 行为不同：前者只加载传统 JAR，后者才触发模块解析。如果项目用了 module-info.java，但启动时只传了 -cp，JVM 会忽略模块声明，导致依赖类“看似存在却无法链接”。
- 运行时显式指定模块路径：
java --module-path mods --module myapp/mypackage.Main - 若仍需兼容传统 classpath，加
--add-modules ALL-SYSTEM强制导入所有系统模块（仅调试用，不推荐长期依赖） - Maven 构建时确保
maven-compiler-plugin和maven-jar-plugin配置与目标 JDK 版本对齐，避免生成不兼容的模块描述符
验证依赖是否被 Maven/Gradle 正确传递到运行时
OpenJDK 对类加载更严格，尤其在多模块或 fat-jar 场景下，容易漏掉传递依赖。比如 org.jboss.logging 报 NoClassDefFoundError，往往不是你直接用了它，而是 Spring Boot 或 Hibernate 暗中依赖它，而构建工具没把它打进最终包里。
- 用
jar -tf your-app.jar | grep jboss确认关键依赖是否存在 - Maven 用户执行
mvn dependency:tree -Dincludes=org.jboss.logging查看该依赖是否被provided或testscope 排除 - Gradle 用户检查
runtimeOnly是否遗漏了桥接库（如slf4j-jboss-logging） - 避免手动修改
MANIFEST.MF中的Class-Path字段——OpenJDK 会校验签名，路径错误直接静默失败
留意 JVM 启动参数和容器环境差异
同一个 JAR 在本地 java -jar 能跑，放到 Docker 或 Tomcat 就报 NoClassDefFoundError，常见于三类干扰：
- Docker 镜像基础层用的是精简 JRE（如
eclipse-jre），缺java.desktop模块——启动时加--add-modules java.desktop - Tomcat 8.5+ 默认使用
ParallelWebappClassLoader，隔离了应用和容器的类加载器；若你在WEB-INF/lib放了log4j-api却没放log4j-core，就会在日志初始化阶段崩 - Kubernetes 环境下，
initContainer提前解压的依赖目录权限为root，而主容器以非 root 用户运行，导致类文件不可读——检查ls -l输出的权限位
真正麻烦的从来不是找不到哪个类，而是“为什么这个类在编译时不报错、打包时不提醒、启动日志里也不说缺什么”。OpenJDK 的报错堆栈常截断在最上层业务类，实际断点可能藏在某个静态初始化块里——建议在出错类的 static { } 块首行加 System.err.println("loading " + MyClass.class);，快速定位触发时机。
