JPA OneToMany关联：子表外键未持久化问题排查

问题原因 #

• 双向关联未完整维护：@OneToMany的mappedBy指定TblApplicationAddress是关联的拥有方，只有子实体中applicationMembershipByApplicationMembershipId字段被正确赋值时，EclipseLink才会生成外键值。当前仅将子实体加入父实体的集合，未设置子实体指向父实体的引用，导致ORM无法识别关联关系。
• merge操作特性：merge会将传入对象的状态复制到托管实体，若传入的子实体未携带父引用，merge后托管实体也不会自动补全该关联。

解决方案 #

1. 在父实体中添加维护双向关联的方法 #

在TblApplicationMembership中添加添加子实体的方法，确保添加子实体时同时设置子实体的父引用：

@Getter
@Setter
@Entity
@Table(name = "application_membership", schema = "obd")
public class TblApplicationMembership {
    // 原有字段...

    // 初始化集合避免空指针
    @OneToMany(mappedBy = "applicationMembershipByApplicationMembershipId", cascade = CascadeType.PERSIST)
    @JsonManagedReference
    private Collection<TblApplicationAddress> applicationAddressesByApplicationMembershipId = new ArrayList<>();

    // 维护双向关联的核心方法
    public void addApplicationAddress(TblApplicationAddress address) {
        this.applicationAddressesByApplicationMembershipId.add(address);
        address.setApplicationMembershipByApplicationMembershipId(this);
    }
}

2. 构建对象时使用关联维护方法 #

创建实体对象时，通过父实体的addApplicationAddress方法添加子实体，而非直接操作集合：

// 构建会员实体
TblApplicationMembership membership = new TblApplicationMembership();
membership.setMembershipReferenceNumber("REF123");
// 设置其他字段...

// 构建地址实体
TblApplicationAddress address = new TblApplicationAddress();
address.setAddressTypeCode("HOME");
address.setAddressLine1Number("123 Main St");
// 设置其他字段...

// 用维护方法关联两者
membership.addApplicationAddress(address);

// 关联申请与会员
TblApplication application = new TblApplication();
application.setApplicationReferenceNumber("APP456");
application.setApplicationMembershipByApplicationMembershipId(membership);
// 设置其他字段...

// 保存申请
tblApplication = applicationDataService.save(tblApplication);

3. 优化持久化操作（可选） #

如果确定保存的是全新实体，可将数据服务中的merge替换为persist，避免merge带来的额外状态复制逻辑：

public T save(T t) throws DataServiceException {
    try {
        em.persist(t);
        em.flush();
        em.clear();
        return t;
    } catch (Exception ex) {
        throw new DataServiceException("Error BaseDataService.save...", ex);
    }
}

若需要兼容新旧实体的保存，保留merge即可，但必须确保对象树的双向关联完整。

关键说明 #

JPA双向关联中，拥有方（子实体的@ManyToOne字段）的状态决定了数据库中外键的取值，父实体的集合只是反向关联的视图，不会直接影响外键。必须同时维护双方的关联关系，ORM才能正确生成关联的SQL语句。

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