Spring Boot双大括号初始化实体报org.hibernate.MappingException: Unknown Entity

语法糖本质 #

Java中的双大括号初始化并不是官方提供的特殊初始化机制，只是利用了匿名内部类和实例初始化块的组合语法糖，你写的new Document() {{ ... }}代码实际完成的操作是：

• 第一层大括号：声明一个继承自Document的匿名内部类，JVM会自动为该类生成外部类名$序号格式的类名，也就是你输出的com.josephrodriguez.learning.springboot.controller.BulkController$1
• 第二层大括号：定义匿名内部类的实例初始化块，在类实例化时执行块内的setter方法完成属性赋值
• 最终返回的是这个匿名内部类的实例，而非原始Document类的实例

Hibernate报错根因 #

JPA/Hibernate的实体映射仅识别标注了@Entity注解的原始类，你创建的Document匿名子类没有被纳入实体映射规则，Hibernate的元数据中不存在该子类的映射配置，因此会抛出Unknown entity的映射异常。

双大括号初始化的其他隐患 #

除了上述类型不匹配问题外，这种写法还存在两个常见风险：

• 匿名内部类会隐式持有外部类的引用，若该实例的生命周期长于外部类，会触发内存泄漏
• 大部分序列化框架依赖类的固定结构，匿名内部类的序列化、反序列化操作大概率会失败

推荐替代写法 #

常规Setter写法 #

.map(record -> {
    Document doc = new Document();
    doc.setSource(record.get(0));
    doc.setCodeListCode(record.get(1));
    doc.setCode(record.get(2));
    doc.setDisplayValue(record.get(3));
    doc.setLongDescription(record.get(4));
    return doc;
})

Lombok建造者写法 #

如果项目引入了Lombok，可以给Document类添加@Builder注解，直接用建造者模式赋值：

.map(record -> Document.builder()
        .source(record.get(0))
        .codeListCode(record.get(1))
        .code(record.get(2))
        .displayValue(record.get(3))
        .longDescription(record.get(4))
        .build()
)

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