Play Framework与Pac4j热类重载异常求助：自定义子类类型转换错误

我们的Java应用基于OpenJDK 12，采用Play Framework v2.8.16的多模块架构，搭配Pac4j v10.0.2作为安全框架。在Play开发模式的热重载过程中，继承Pac4j类型的自定义类会触发ClassCastException，该问题在相同依赖环境下出现频率不稳定，无论通过IntelliJ IDE还是SBT命令行启动都会发生。

自定义类示例：

public class CustomJwtProfile extends org.pac4j.jwt.profile.JwtProfile

热重载失败时的错误日志：

play.api.PlayException: Execution exception[[ClassCastException: class my.package.CustomJwtProfile cannot be cast to class class my.package.CustomJwtProfile (class my.package.CustomJwtProfile is in unnamed module of loader
play.runsupport.DelegatedResourcesClassLoader @2a1321ec; my.package.CustomJwtProfile is in unnamed module of loader
play.runsupport.DelegatedResourcesClassLoader @47424930)]]

推测核心原因：Play热重载通过不同类加载器重新加载整个应用，导致同一类被两个类加载器实例加载，JVM将其视为不同运行时类型；同时Pac4j的全局缓存或残留对象未随应用代码更新，仍关联旧类加载器的类实例，最终触发类型转换异常。目前只能通过重启Play进程解决，严重拖慢开发效率。

1. 调整Play热重载的类加载策略 #

强制让Pac4j核心类与自定义子类使用同一类加载器，避免类加载隔离导致的类型不匹配：

• 在build.sbt中将Pac4j依赖标记为父类加载器加载，排除在热重载范围外：

  PlayKeys.playDependencyClasspath += "org.pac4j" % "pac4j-jwt" % "10.0.2"
  

• 配置Play监控重载的路径，排除Pac4j相关Jar包，避免触发不必要的类加载：

  PlayKeys.devSettings += "play.dev.watch" := "!lib/pac4j-*.jar"
  

2. 清空Pac4j全局对象缓存 #

Pac4j的全局缓存会残留旧类加载器的Profile实例，需在应用重载时主动清理：

• 利用Play的ApplicationLifecycle钩子，在应用停止（热重载触发的停止）时清空Pac4j缓存：

  @Inject
  public class AppCleanupHook {
      public AppCleanupHook(ApplicationLifecycle lifecycle) {
          lifecycle.addStopHook(() -> {
              // 清空Pac4j的Profile全局缓存
              ProfileManager.clearGlobalCache();
              // 若使用自定义JWT存储容器，同步清理
              CustomJwtStore.getInstance().clearAll();
              return CompletableFuture.completedFuture(null);
          });
      }
  }
  

• 避免将自定义Profile实例存储在静态变量或跨请求的全局容器中，改用Play的Http.Context做请求级存储。

3. 优化自定义Profile实现 #

减少静态依赖，确保类实例与当前类加载器绑定：

• 移除自定义Profile中的静态变量或全局状态，让实例生命周期与请求绑定；
• 若Profile需要序列化，实现readResolve方法确保反序列化时使用当前类加载器：

  private Object readResolve() throws ObjectStreamException {
      ClassLoader currentLoader = CustomJwtProfile.class.getClassLoader();
      return Class.forName(this.getClass().getName(), true, currentLoader).cast(this);
  }
  

4. 调整框架版本适配 #

检查Play与Pac4j的版本兼容性，修复已知类加载器Bug：

• 升级Play到v2.8.x系列的最新补丁版本，官方可能已修复热重载类加载器的隔离问题；
• 调整Pac4j版本到与Play v2.8.16更兼容的分支，参考Pac4j官方文档的容器适配说明。

5. 自定义Play热重载类加载器 #

扩展Play的类加载器，强制清理旧类加载器的所有引用：

• 实现DelegatedResourcesClassLoader子类，重载close方法时主动清理所有关联对象；
• 在build.sbt中指定使用自定义类加载器：

  PlayKeys.devClassLoader := (classpath, appClassLoader) => new CustomDelegatedClassLoader(appClassLoader, classpath)
  

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