Hibernate @OneToOne一对一关联映射外键为NULL问题求助

问题核心原因 #

• 错误使用@PrimaryKeyJoinColumn：该注解要求两个关联实体主键值完全一致，你的两个实体主键均为独立自增策略，无法保证id同步，自然无法匹配关联
• 双向@OneToOne未指定关系维护端：缺少mappedBy属性配置，JPA无法识别哪个实体负责维护外键字段，不会主动写入外键值
• 双向关联未同步设置两端属性：就算注解配置正确，持久化时仅设置单侧关联属性，Hibernate也不会自动填充另一侧的外键

修复方案 #

方案1：使用外键关联（推荐，不需要共享主键） #

我们以Key实体作为关系维护端为例修改：

1. 修改Client实体代码：

@Entity
@Data
@NoArgsConstructor
@AllArgsConstructor
public class Client {

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

    @Size(max = 100)
    private String name;

    @Email(message = "Email should be valid")
    private String email;

    // 去掉@PrimaryKeyJoinColumn，添加mappedBy指定关系由Key的client属性维护
    @OneToOne(mappedBy = "client", fetch = FetchType.LAZY)
    private Key key;
}

2. 修改Key实体代码：

@Entity
@Data
@NoArgsConstructor
@AllArgsConstructor
public class Key {

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

    @Column(unique = true)
    private UUID number;

    // 作为关系维护端，指定外键字段名，可加可选约束
    @OneToOne
    @JoinColumn(name = "client_id", unique = true, nullable = false)
    private Client client;

    public Key(UUID number) {
        this.number = number;
    }
}

3. 持久化时必须同步设置两端关联：

// 示例保存代码
Client client = new Client();
client.setName("测试用户");
client.setEmail("test@example.com");
// 先存主控端的关联实体
clientRepository.save(client);

Key key = new Key(UUID.randomUUID());
// 设置Key侧的关联属性（关系维护端必须设）
key.setClient(client);
// 同步设置Client侧的关联属性，保证内存中对象一致
client.setKey(key);
// 存Key实体，此时会自动写入client_id外键
keyRepository.save(key);

如果需要级联保存，可在Client的@OneToOne注解中添加cascade = CascadeType.ALL属性，设置好两端关联后直接保存Client即可自动同步Key的持久化和外键写入。

方案2：坚持使用共享主键的场景 #

如果确实需要使用@PrimaryKeyJoinColumn共享主键，需要修改主键生成策略，保证Key的id和Client的id完全一致：

1. Key实体主键使用@MapsId注解继承Client的id：

@Entity
@Data
@NoArgsConstructor
@AllArgsConstructor
public class Key {

    @Id
    private Long id;

    @Column(unique = true)
    private UUID number;

    @OneToOne
    @MapsId
    private Client client;

    public Key(UUID number) {
        this.number = number;
    }
}

2. Client实体的@OneToOne保留@PrimaryKeyJoinColumn配置即可，保存逻辑和方案1一致。

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