Netbeans 8.2项目无法在Glassfish或Tomcat服务器运行问题问询

核心故障原因 #

从你提供的Glassfish报错截图可以识别到典型的Java EE API包冲突+类加载策略不兼容问题，这是原适配Tomcat的应用迁移到Glassfish时最高发的故障：

• Tomcat属于轻量Web容器，仅内置Servlet、JSP等基础Web层规范实现，应用通常会自行引入持久层、REST服务等其他Java EE规范的API或实现包
• Glassfish是全量Jakarta EE（原Java EE）兼容应用服务器，本身已经内置了所有Java EE规范的官方实现，应用中自带的同类型包会和Glassfish内置包产生类加载冲突，直接触发启动失败。

具体修复步骤 #

• 第一步：清理依赖配置中的冗余EE包
  如果你用Maven/Gradle管理依赖，所有Java EE相关依赖全部调整scope为provided，告知构建工具不要把这类包打入WAR包，直接使用Glassfish内置的版本，Maven配置示例：

  <dependency>
      <groupId>javax</groupId>
      <artifactId>javaee-api</artifactId>
      <version>8.0</version>
      <scope>provided</scope>
  </dependency>
  

  重点排查的依赖包括：javax.servlet、javax.persistence、javax.ws.rs、javax.ejb、hibernate-entitymanager、jackson-jaxrs等和EE规范绑定的包，无需在应用中重复引入实现包。

• 第二步：适配Glassfish类加载策略
  Glassfish默认使用父类优先的类加载策略，和Tomcat默认的子类优先策略不同，如果应用有自定义类加载逻辑，可在WEB-INF/glassfish-web.xml中添加配置，切换为和Tomcat一致的子类优先加载逻辑：

  <class-loader delegate="false"/>
  

• 第三步：移除Tomcat专属依赖类
  清理项目中依赖Tomcat私有API的类，比如org.apache.catalina.*开头的类，这类API在Glassfish环境中不存在，直接删除或者替换为Java EE标准API实现即可。

• 第四步：校验Netbeans运行配置
  打开Netbeans项目属性-运行配置，确认服务器选项选中目标Glassfish实例，Java EE版本选择和项目适配的版本一致，不要和Tomcat的运行配置混用。

验证修复 #

完成上述修改后清空Glassfish缓存目录（默认路径glassfish/domains/domain1/generated、glassfish/domains/domain1/osgi-cache），重新部署应用即可正常启动。

内容的提问来源于stack exchange，提问作者Mohammed Kashcoul