Hibernate如何配置以支持手动设置实体类主键？

问题本质 #

你遇到的报错本质是两个问题叠加：

1. JPA 规范要求实体类必须提供公共无参构造方法用于反射实例化，你当前的实体类只加了@Builder和@Data注解，@Builder会生成全参构造，此时Java不会默认提供无参构造。
2. 你手动设置id保存时，JPA会先查询数据库判断该主键是否存在，查询返回的结果需要用无参构造实例化对象，因此触发报错；而不手动设置id时，JPA直接判定为新实体执行插入，不需要先查询构造对象，因此暂时没有暴露无参构造缺失的问题。

修改步骤 #

1. 给实体类补充构造相关Lombok注解，同时明确指定主键为手动赋值策略：

import jakarta.persistence.GeneratedValue;
import jakarta.persistence.GenerationType;
import lombok.AllArgsConstructor;
import lombok.NoArgsConstructor;

@Entity
@Data
@Builder
@NoArgsConstructor // 生成JPA所需的无参构造
@AllArgsConstructor // 配合@Builder正常使用，@Builder依赖全参构造
public class User {
    @Id
    // 明确指定主键由程序手动赋值，JPA不自动生成
    @GeneratedValue(strategy = GenerationType.ASSIGNED)
    private int id;
    private String name;
}

2. 低版本JPA/Hibernate兼容写法
   如果你的项目使用的是JPA 2.2及更早版本，没有GenerationType.ASSIGNED枚举，可改用以下主键配置：

import org.hibernate.annotations.GenericGenerator;

@Id
@GenericGenerator(name = "manual_id", strategy = "assigned")
@GeneratedValue(generator = "manual_id")
private int id;

assigned策略明确告知Hibernate，主键值由业务代码手动提供，不需要框架自动生成。

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