Hibernate Search字节码增强异常：子类缺失读取方法求助

环境版本 #

• Java 21
• Spring Boot 3.2.7
• Hibernate 6.4.9.Final
• hibernate-search-backend-elasticsearch:7.1.0.Final
• VM参数：-javaagent:/aspectjweaver-1.9.22.jar -javaagent:/spring-instrument-6.1.10.jar

问题复现代码 #

@Indexed
@Entity
abstract class Parent {
    @GenericField(projectable = Projectable.YES, sortable = Sortable.YES, searchable = Searchable.YES)
    private LocalDateTime createdDate;
}

@Entity
class Child extends Parent {

}

启动错误日志 #

Caused by: java.lang.NoSuchMethodException: com.project.Child.$$_hibernate_read_createdDate()
  at java.base/java.lang.Class.getMethod(Class.java:2395)
  at org.hibernate.search.mapper.orm.model.impl.HibernateOrmBootstrapIntrospector.getBytecodeEnhancerReaderMethod(HibernateOrmBootstrapIntrospector.java:187)
  ... 80 common frames omitted

问题分析 #

调试发现异常由Hibernate Search内部的getBytecodeEnhancerReaderScheme方法抛出：

private static Method getBytecodeEnhancerReaderScheme(Class<?> holderClass, Field field) {
    if (!PersistentAttributeInterceptable.class.isAssignableFrom(holderClass)) {
        return null;
    } else {
        try {
            return holderClass.getMethod("$$_hibernate_read_" + field.getName());
        } catch (NoSuchMethodException e) {
            throw new AssertionFailure("Read method for enhanced field " + field + " is unexpectedly missing.", e);
        }
    }
}

当子类实体Child被标记为PersistentAttributeInterceptable时，逻辑会尝试获取父类字段createdDate对应的字节码增强读取方法$$_hibernate_read_createdDate，但该方法并未在子类中生成。经测试，移除-javaagent:/spring-instrument-6.1.10.jar参数后，方法会按预期返回null，异常消失，推测是Spring Instrument代理与Hibernate字节码增强机制冲突导致。

解决方案 #

1. 移除Spring Instrument代理参数：若业务无需Spring Instrument的动态类加载增强功能，直接删除VM参数中的-javaagent:/spring-instrument-6.1.10.jar，即可解决问题。
2. 添加父类字段Getter方法：在父类Parent中为createdDate添加public或protected的getter方法，让Hibernate Search通过getter访问字段，绕过字节码增强方法的查找逻辑：

   @Indexed
   @Entity
   abstract class Parent {
       @GenericField(projectable = Projectable.YES, sortable = Sortable.YES, searchable = Searchable.YES)
       private LocalDateTime createdDate;
   
       public LocalDateTime getCreatedDate() {
           return createdDate;
       }
   }
   

3. 调整代理加载顺序：若必须保留Spring Instrument，尝试调整VM参数顺序，将spring-instrument代理放在aspectjweaver之后加载，或优先加载Hibernate的字节码增强代理（需确保项目中配置了Hibernate增强插件）。
4. 升级Hibernate Search版本：检查Hibernate Search官方版本更新，尝试升级到7.2.x及以上版本，看是否已修复该继承场景下的字节码增强检测问题。

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