同一类ClassCastException排查：代码正常过 redeploy后失效（NetBeans+GlassFish）

问题场景还原 #

你遇到的这个问题特别典型：原本运行正常的代码，只是修改了几个无关的System.out.println语句，重部署后就抛出了诡异的java.lang.ClassCastException: reichling.parkhausserver.entity.DbParkhaus cannot be cast to reichling.parkhausserver.entity.DbParkhaus异常，重启服务器又恢复正常。结合你用NetBeans+GlassFish的环境，这基本可以确定是类加载器冲突导致的。

核心原因分析 #

JVM判断两个类是否为同一类型，不仅看全类名，还要看加载它们的类加载器是否相同。GlassFish在热部署/重部署时，有时候旧的类加载器没有被彻底销毁回收，新的类加载器又加载了新版本的DbParkhaus类。这时候，从EJB返回的DbParkhaus对象是旧类加载器加载的实例，而你代码中要转换的是新类加载器加载的DbParkhaus类型，JVM就会认为这是两个不同的类型，抛出类型转换异常。

具体解决思路 #

• 禁用GlassFish的类加载器缓存
  打开GlassFish管理控制台（默认地址http://localhost:4848），找到你的应用进入配置页，找到"ClassLoader Cache"相关的选项，把启用缓存的开关关掉。这样每次重部署都会创建全新的类加载器，不会复用旧的加载器实例，从根源避免冲突。

• 彻底清理缓存目录
  有时候残留的缓存文件会导致类加载混乱，手动清理这两个地方：

  1. NetBeans缓存：找到NetBeans的用户目录（Windows一般是C:\Users\<你的用户名>\AppData\Roaming\NetBeans\<版本号>，Mac是~/Library/Application Support/NetBeans/<版本号>），删除cache和var目录下的内容；
  2. GlassFish缓存：进入GlassFish安装目录的domains\<你的域名>，删除generated、cache、applications这三个目录里的所有文件，然后重启服务器重新部署。

• 调整NetBeans的部署设置
  在NetBeans里右键你的项目，选择「Properties」→「Run」，找到Deployment区域，勾选「Force redeployment」和「Clean and build before running」。这样每次部署前都会彻底清理旧的构建产物和部署文件，避免残留的旧类文件干扰。

• 检查项目依赖，避免重复类
  确认DbParkhaus实体类没有被重复打包到多个模块中（比如同时出现在EJB模块和WAR模块，或者lib目录里有重复的jar包）。如果同一个类被多个模块的类加载器加载，也会导致这种类型冲突。可以在NetBeans的项目依赖里检查，确保实体类只在一个核心模块中定义，其他模块通过依赖引用。

• 修改GlassFish的类加载策略
  打开GlassFish的domains\<你的域名>\config\domain.xml文件，找到你的应用对应的<application>节点，添加属性class-loader="delegate=false"，让应用自己的类加载器优先加载本地类，而不是委托给容器的类加载器，避免类被容器和应用重复加载。

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