Glassfish本地路径配置：解决Glassfish4部署时ClassNotFoundException问题

嘿，我之前也踩过GlassFish这个类找不到的坑，大概率是类路径或者部署配置出了问题，咱们一步步来排查修复：

1. 先检查Web应用的基础部署结构 #

这是最常见的出错点，别先急着动GlassFish的全局配置：

• 确保你的应用专属依赖JAR都老老实实放在WEB-INF/lib目录下，Web容器默认只会从这个目录加载应用级别的依赖，别把依赖丢到GlassFish的根目录lib里（除非是多个应用共用的全局依赖）。
• 确认编译后的.class文件都在WEB-INF/classes目录下，手动打包的话要注意别漏了这个目录，IDE编译通常会自动处理，但可以去输出目录核对一下。

2. 全局依赖的GlassFish路径配置（如果需要） #

要是有多个应用共用的JAR，比如自定义的工具类库，可以放到GlassFish的全局类路径：

• 把JAR复制到glassfish4/glassfish/lib（所有域都会加载），或者glassfish4/glassfish/domains/[你的域名]/lib（仅给指定域加载）。
• 放完必须重启GlassFish域，不然新加入的JAR不会生效，执行命令：

  asadmin stop-domain [你的域名]
  asadmin start-domain [你的域名]
  

3. 手动指定域的额外类路径 #

如果需要加载一些不在默认路径里的类或库，可以通过管理控制台配置：

1. 打开GlassFish管理控制台（默认地址http://localhost:4848）
2. 进入你的目标域 → 配置 → JVM设置 → 切换到「JVM选项」标签
3. 添加新的JVM参数，格式如下：

   -classpath /path/to/your/extra/libs:/path/to/compiled/classes
   

   注意：Windows系统用分号;分隔路径，Linux/macOS用冒号:。
4. 保存配置后重启域，让新的类路径生效。

4. IDE集成部署的路径检查 #

如果你是用Eclipse或IntelliJ直接部署到GlassFish：

• Eclipse：右键项目 → 属性 → 部署程序集，确认WEB-INF/lib和WEB-INF/classes都被包含在部署包中，所有依赖库都正确映射到WEB-INF/lib。
• IntelliJ：打开项目结构 → 模块 → 工件，检查Web工件的输出配置，确保所有需要的依赖都被添加到WEB-INF/lib，编译后的类文件输出到WEB-INF/classes。

5. 核对WAR包的完整性 #

如果是手动打包WAR文件：

• 用解压工具打开WAR，检查WEB-INF/lib下是否有所有依赖JAR，WEB-INF/classes下是否有完整的编译类文件。
• 用Maven打包的话，确保pom.xml里的依赖范围设置正确：应用专属依赖用compile，GlassFish自带的Java EE API可以用provided（避免重复打包）。

最后提醒一句：不管改了哪个配置，一定要重启GlassFish域，不然新的配置不会被加载哦！

内容的提问来源于stack exchange，提问作者Stunt Super