JPA新增Resident实体报ids for this class must be manually assigned如何解决

这个报错是JPA/Hibernate的通用校验异常，触发条件是：实体类主键没有配置自动生成策略、且调用save()/persist()方法前未给主键字段赋值。
此前运行正常近期报错，大概率是近期代码改动删了主键赋值逻辑、或者字段映射出现偏差、或是JPA版本升级变更了默认主键策略。

1. 补全实体类主键配置 #

你当前的实体类没有显式指定主键生成策略，默认走「手动赋值」逻辑，建议显式声明避免版本兼容问题，修改后实体类代码如下：

@Entity
@Table(name = "residents")
public class Resident implements Serializable {
    private static final long serialVersionUID = -9052313410222202916L;
    @Id
    @Column(name = "resident_id", length = 15, nullable = false)
    // 显式声明主键由业务代码手动赋值
    @GeneratedValue(strategy = GenerationType.ASSIGNED)
    // 建议Java字段用驼峰命名，避免默认命名策略导致字段映射错误
    private String residentId;

    // 补全getter、setter方法
    public String getResidentId() {
        return residentId;
    }

    public void setResidentId(String residentId) {
        this.residentId = residentId;
    }
    // 其他字段的getter、setter省略
}

注意：要确保residentId的getter、setter方法存在且命名正确，避免框架无法读写字段值。

2. 排查业务保存逻辑 #

检查调用保存方法前的代码，必须先给主键字段赋值后再执行保存，示例逻辑：

// 构造实体对象
Resident newResident = new Resident();
// 先赋值自定义主键
newResident.setResidentId("自定义的15位以内ID值");
// 赋值其他必填字段
newResident.setResidentName("张三");
newResident.setResidentLastName("张");
// 最后执行保存
entityManager.persist(newResident);

重点排查：

• 有没有近期代码改动删除了主键赋值逻辑
• 前端/上游传参的主键字段名是否和接收参数的字段名匹配，有没有出现传值为null的情况

3. 排查全局配置变更 #

如果前两步都没问题，检查近期是否有如下变更：

• 升级了Hibernate/Spring Data JPA版本
• 修改了spring.jpa.hibernate.naming相关的命名策略配置，导致主键字段映射失败
• 新增了全局主键生成策略配置，覆盖了实体类的自定义配置

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