在GlassFish上运行应用时遭遇NoClassDefFoundError问题

你在部署Web应用到GlassFish时遇到的这个问题很常见——明明在项目里加了dom4j.jar，服务器运行时却还是找不到对应的类。先来看下你提供的错误核心信息：

2018-05-18T11:23:00.332+0500|Severe: Initial SessionFactory creation failed.java.lang.NoClassDefFoundError: org/dom4j/DocumentException

这个错误大多不是JAR没添加，而是JAR没有被正确部署到服务器可访问的路径，或者存在类加载相关的问题。下面给你几个具体的排查和解决步骤：

• 确保JAR被部署到WEB-INF/lib目录
  很多开发者只在Eclipse的Build Path里添加了JAR，但没配置让它被包含到部署包中。右键你的项目 → Properties → Deployment Assembly，检查列表里是否有dom4j.jar。如果没有，点击Add → Java Build Path Entries → 选中dom4j.jar，这样部署时它会自动复制到应用的WEB-INF/lib目录下，服务器就能正常加载类了。

• 验证dom4j JAR的完整性
  有可能你下载的JAR包损坏了，导致类无法被正确读取。重新从官方渠道下载对应版本的dom4j JAR，替换项目里的现有文件，刷新项目后再尝试部署。

• 清理GlassFish服务器缓存
  GlassFish的缓存有时候会保留旧的部署信息，导致新添加的JAR不生效。找到GlassFish安装目录下的domains/[你的域名]/cache文件夹，删除里面的所有内容，重启服务器后重新部署应用。

• 检查Build Path中JAR的作用范围
  右键项目里的dom4j.jar → Build Path → Configure Build Path，在Libraries标签下查看它的属性，确保作用范围是Compile，而不是Provided。如果是Provided，Eclipse编译时会使用这个JAR，但部署时不会把它打包到应用中，服务器自然找不到对应的类。

• 清理并重新构建项目
  Eclipse的缓存可能会引发一些奇怪的问题，执行Project → Clean，选择你的项目进行清理，然后重新构建项目，再部署到服务器试试。

内容的提问来源于stack exchange，提问作者Ali Mehdi