Grails实体p.id转Long偶发ClassCastException问题排查与修复

问题场景 #

现有一段Groovy代码：

try {
    Long id = p.id as Long
    ...
} catch (all){
    log.warn "Class p.id:${p.id.class} p.class:${p.class} '${p.id}' ${p}", all
}

其中p是Grails实体Person的实例，其id字段定义为Long类型。但这段代码会周期性抛出异常（失败率低于1%），报错行指向Long id = p.id as Long，错误日志如下：

27/06 18:00:54.227 WARN xx.xx.LinksTagLib - Class p.id:class java.lang.Long p.class:class x.xx.elements.Person '58858' Person{id=58858}
java.lang.IllegalArgumentException: java.lang.ClassCastException@4203c306
        at jdk.internal.reflect.GeneratedMethodAccessor449.invoke(Unknown Source)
        at java.base/jdk.internal.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
        at java.base/java.lang.reflect.Method.invoke(Method.java:566)
        at org.codehaus.groovy.reflection.CachedMethod.invoke(CachedMethod.java:107)
        at groovy.lang.MetaMethod.doMethodInvoke(MetaMethod.java:323)
        at groovy.lang.MetaClassImpl.getProperty(MetaClassImpl.java:1956)
        at groovy.lang.ExpandoMetaClass.getProperty(ExpandoMetaClass.java:1150)
        at groovy.lang.MetaClassImpl.getProperty(MetaClassImpl.java:3843)
        at groovy.lang.ExpandoMetaClass.getProperty(ExpandoMetaClass.java:1162)
        at org.codehaus.groovy.runtime.callsite.PogoMetaClassGetPropertySite.getProperty(PogoMetaClassGetPropertySite.java:50)
        at org.codehaus.groovy.runtime.callsite.AbstractCallSite.callGetProperty(AbstractCallSite.java:329)
        at xx.xxx.LinksTagLib$_closure13.doCall(LinksTagLib.groovy:326)

补充：以下比较代码也会抛出ClassCastException：

Long b = 100
if (b == p.id){
...
}

环境信息：

• Java 11
• Groovy 3.0.11

原因分析 #

1. Hibernate代理延迟加载的异常包装：Grails默认通过Hibernate代理实现实体延迟加载，当p是未初始化的代理对象时，访问p.id会触发Hibernate从数据库加载实体数据。在高并发、session已关闭或数据库连接异常的场景下，加载过程可能抛出底层异常，被Groovy的属性访问机制包装为包含ClassCastException的IllegalArgumentException。
2. 异常后状态恢复的假象：catch块中能正常打印p.id的类型和值，是因为异常触发后，Hibernate可能完成了代理初始化，或者当前线程的session状态已恢复，导致catch阶段访问属性时恢复正常。
3. 并发场景下的session冲突：如果多个请求共享同一个Hibernate session，可能导致实体状态混乱，访问属性时触发类型转换异常。

修复方案 #

• 提前初始化代理对象：在访问id属性前，确保实体已完成初始化，可调用Hibernate的初始化方法：

  import org.hibernate.Hibernate
  Hibernate.initialize(p)
  Long id = p.id
  

  或在查询实体时使用fetch all properties避免延迟加载。
• 确保session有效期间访问属性：将实体属性的获取逻辑放在Grails的service层（request session有效范围内），避免在taglib等后续阶段访问代理属性。
• 使用安全的类型转换方式：替代Groovy的as操作符，采用更稳定的显式转换：

  Long id = p.id != null ? Long.valueOf(p.id.toString()) : null
  

• 直接调用Getter方法：绕过Groovy的元编程属性访问，直接调用实体的Getter方法减少异常包装：

  Long id = p.getId()
  

• 规范session管理：在高并发场景下，确保每个请求使用独立的Hibernate session，避免session共享导致的状态异常。

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