JPA关联异常：ClientID未自动保存至Address表

你的问题出在一对一关联的配置错误以及关联维护端的关系未正确设置，导致JPA无法自动维护外键clientId。

1. 实体关联配置错误 #

核心错误点： #

• Client类的@OneToOne同时使用了mappedBy和@JoinColumn，二者冲突：mappedBy表示该实体是关联的被维护端，外键由另一方（Address）维护，此时不能再用@JoinColumn指定外键列。
• 保存数据时未双向设置关联关系，JPA仅会维护维护端（拥有外键的一方）的关联，若未在维护端设置关联对象，外键将无法自动填充。

2. 修正后的实体代码 #

Client类（被维护端） #

@Entity
@Getter
@Setter
@NoArgsConstructor
@AllArgsConstructor
@Table(name = "client")
public class Client implements Serializable {
    @Serial
    private static final long serialVersionUID = 1L;

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @Column(name = "name")
    private String name;

    @Column(name = "cpf", nullable = false)
    private String cpf;

    @Column(name = "password", nullable = false)
    private String password;

    @Column(name = "registration_data")
    @JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "MM-dd-yyyy HH:mm", timezone = "GMT")
    private Date registrationData;

    @OneToMany(mappedBy = "clientId")
    private List<Contact> contacts;

    // 仅保留mappedBy，表明由Address维护关联关系
    @OneToOne(cascade = CascadeType.ALL, mappedBy = "clientId")
    private Address address;

    // 修正外键列名为规范的client_id，避免语义混淆
    @OneToMany(fetch = FetchType.LAZY, cascade = CascadeType.ALL)
    @JoinColumn(name = "client_id")
    private List<Pet> pets;

    @Column(name = "type_profile", nullable = false)
    private String typeProfile;

    @Lob
    @Basic(fetch = FetchType.LAZY)
    @Column(name = "image")
    private byte[] image;
}

Address类（维护端，拥有外键） #

@Entity
@Getter
@Setter
@NoArgsConstructor
@Table(name = "address")
public class Address implements Serializable {
    @Serial
    private static final long serialVersionUID = 1L;
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    // 明确关联Client，设置unique保证一对一唯一性，optional=false确保关联非空
    @OneToOne(optional = false)
    @JoinColumn(name = "client_id", unique = true)
    private Client clientId;

    @Column(name = "publicPlace")
    private String publicPlace;

    @Column(name = "city")
    private String city;

    @Column(name = "district")
    private String district;

    @Column(name = "complement")
    private String complement;

    @Column(name = "tag")
    private String tag;
}

3. 保存数据的关键操作 #

保存Client时必须双向设置关联关系，确保维护端（Address）持有Client对象，JPA才会自动填充外键：

// 创建并初始化Client
Client client = new Client();
client.setName("测试用户");
client.setCpf("12345678901");
// 其他属性赋值...

// 创建并初始化Address
Address address = new Address();
address.setPublicPlace("测试街道");
address.setCity("测试城市");
// 其他属性赋值...

// 双向绑定关联
address.setClientId(client);
client.setAddress(address);

// 保存Client（由于cascade=CascadeType.ALL，Address会被级联保存）
clientRepository.save(client);

额外优化建议 #

• 数据库列名建议使用下划线分隔的小写格式（如client_id），符合行业规范，避免与关键字冲突。
• 一对一关联中添加unique=true可强制保证一个Client对应唯一Address，避免数据混乱。

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