Spring Data JPA @OneToOne保存父子实体子表外键为null问题

这不是映射配置错误，是JPA双向关联的核心机制导致的：

• 双向@OneToOne关联中，配置了mappedBy属性的一端是关系反方（非持有端），JPA不会根据这一端的属性值维护外键
• 配置了@JoinColumn的一端是关系持有方，外键字段的写入完全以这一端的关联属性值为准

对照你的实体定义：

• 父表实体DUtente的soggetto字段配置了mappedBy = "utente"，属于关系反方，给这个字段设值不会触发外键维护
• 子表实体DSoggetto的utente字段配置了@JoinColumn(name = "fk_d_utente")，是外键的持有方，只有这个字段指向父实体时，JPA插入子表记录才会给外键列赋值

你仅执行utenteSocio.setSoggetto(soggetto)时，只是给反方属性赋了值，子实体soggetto自身的utente属性依旧是null，JPA级联插入子表时拿不到父表主键，自然会把外键字段存为null。

双向关联手动维护双方引用不是冗余操作，是JPA规范的明确要求，框架本身不会自动帮你补全反向引用。

不要在业务代码中反复手动写两次set逻辑，直接在实体类中封装关联设置方法，自动同步双向引用，从根源避免漏设：

1. 修改父实体DUtente，重写soggetto属性的set方法，同步维护双方关联：

@Entity
@Table(name="d_utente")
@Getter
@Setter
public class DUtente implements Serializable {

    @Id
    @Column(name="id_d_utente")
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Integer idDUtente;

    @OneToOne(
            mappedBy = "utente",
            orphanRemoval = true,
            cascade = CascadeType.ALL)
    private DSoggetto soggetto;

    // 自定义关联设置逻辑，替换Lombok生成的默认setter
    public void setSoggetto(DSoggetto soggetto) {
        // 先清空旧关联的反向引用
        if (this.soggetto != null) {
            this.soggetto.setUtente(null);
        }
        this.soggetto = soggetto;
        // 给关联持有方同步设置引用
        if (soggetto != null) {
            soggetto.setUtente(this);
        }
    }
}

2. 子实体DSoggetto不需要做额外修改，业务层保持原有写法即可：

utenteSocio.setSoggetto(soggetto);
utenteRepository.save(utenteSocio);

这种实现方式既符合JPA的规范要求，也不会让业务代码出现重复的关联设置逻辑，同时能避免后续开发中漏设反向引用导致的外键为null问题。

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