使用@SecondoryTable时如何避免子表空值时自动保存或更新？

核心实现注解 #

你需要使用Hibernate提供的扩展注解 @SecondaryRow（高版本Hibernate）或旧版Hibernate的@org.hibernate.annotations.Table 实现该需求，标准JPA的@SecondaryTable本身不支持该逻辑。

注：你提问中拼写的@SecondoryTable为笔误，正确应为JPA标准注解@SecondaryTable。

具体配置方式 #

Hibernate 5.3+ 版本配置 #

在实体类上添加@SecondaryRow注解，设置optional = true，同时给所有从表映射字段指定table属性：

import jakarta.persistence.Entity;
import jakarta.persistence.Id;
import jakarta.persistence.Column;
import jakarta.persistence.SecondaryTable;
import org.hibernate.annotations.SecondaryRow;

@Entity
@SecondaryTable(name = "t_child_info") // 替换为你的从表名
@SecondaryRow(table = "t_child_info", optional = true) // 核心配置：从表可选，全空不写入
public class ParentEntity {
    @Id
    private Long id;
    
    // 主表其他字段...
    
    // 映射到从表的字段
    @Column(table = "t_child_info")
    private String info;
    // 其他从表字段同理添加table属性
}

低版本Hibernate（5.3以前）配置 #

使用@org.hibernate.annotations.Table的optional属性实现同样效果：

import jakarta.persistence.Entity;
import jakarta.persistence.SecondaryTable;
import org.hibernate.annotations.Table;

@Entity
@SecondaryTable(name = "t_child_info")
@Table(appliesTo = "t_child_info", optional = true)
public class ParentEntity {
    // 字段配置和高版本一致
}

实现逻辑说明 #

• 标准JPA默认@SecondaryTable关联的从表是必选的，即使所有从表映射字段都为空，也会插入一条仅携带关联主键的空记录到从表。
• 配置optional = true后，Hibernate会自动检测所有该从表的映射字段值，若全部为null/空值，就会跳过从表的写入操作，仅保存主表数据。

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