bug现场谜之古老的jar包classpath玄机
内容提要
本文讨论了将Docker中的Java应用迁移到Linux主机的过程。在迁移后启动应用时遇到ClassNotFoundException错误，分析发现问题出在jar包的MANIFEST.MF文件中。通过直接启动包含main()方法的class类，成功解决了问题，强调了理解jar包结构和MANIFEST.MF的重要性。
延伸解读
MANIFEST.MF 如何影响类加载
MANIFEST.MF 中的 Class-Path 属性会为 jar 包指定额外的类路径。当使用 java -jar 启动时，JVM 会读取该属性并加载其中列出的依赖。如果 Class-Path 指向的路径不存在或与实际依赖位置不符，就会导致 ClassNotFoundException。案例中，迁移后依赖目录未随 jar 包一起移动，且 MANIFEST.MF 可能仍指向原环境路径，因此直接 java -jar 启动失败。
迁移时需同步依赖与配置
从 Docker 迁移到 Linux 主机时，不能只复制 jar 包。原容器中 jar 包同目录下存在 SYNC_lib 目录，存放第三方依赖。迁移时必须一并复制，并确保启动命令的 classpath 包含该目录。此外，数据库驱动等依赖的版本也需与目标环境匹配，避免因版本不一致引发新的加载问题。
排查类加载问题的实用方法
遇到 ClassNotFoundException 时，可先检查 classpath 设置是否正确，再确认依赖 jar 包是否实际存在。使用 -verbose:class 参数能打印 JVM 加载的类及其来源 jar 包，帮助定位问题。若怀疑 jar 包本身有问题，可尝试直接运行包含 main() 方法的 class 类，绕过 jar 启动机制，从而判断是否是 MANIFEST.MF 配置导致的异常。
Q&A
在将Docker中的Java应用迁移到Linux主机时，遇到什么错误？
遇到了ClassNotFoundException错误。
ClassNotFoundException错误的原因是什么？
问题出在jar包的MANIFEST.MF文件中，jar包结构与预期不符。
如何解决ClassNotFoundException错误？
通过直接启动包含main()方法的class类，成功解决了问题。
MANIFEST.MF文件在jar包中有什么重要性？
MANIFEST.MF文件是jar包的元数据文件，指明了Main-Class和Class-Path等信息。
在没有构建工具的情况下，如何手动创建jar包？
可以使用命令jar cvfm xxx.jar MANIFEST.txt com.xxx.xxx来创建jar包。
现代开发环境如何简化jar包的打包过程？
现代开发环境通过IDE集成开发工具，简化了打包过程，不需要手动敲命令。
