使用@IdClass实现复合主键时插入新数据提示Column 'id' cannot be null

针对你遇到的问题，以下是几个排查和解决的关键点：

1. 确保实体对象的主键字段已正确赋值 #

插入新记录时，必须明确给YourEntity的id和version字段赋值，不能依赖基本类型的默认值（int默认0可能不符合数据库约束）。示例代码：

YourEntity newEntity = new YourEntity();
newEntity.setId(3); // 明确设置id为3
newEntity.setVersion(1); // 新增记录版本号建议从1开始
entityManager.persist(newEntity); // 使用persist而非merge，确保是插入操作

2. 完善MyKey类的实现 #

复合主键类MyKey必须满足JPA的要求，否则会导致主键无法正确识别：

• 必须添加无参构造器（JPA需要通过反射实例化）
• 重写equals()和hashCode()方法（JPA依赖这两个方法判断主键唯一性）
• 字段名、类型必须与实体类中@Id标注的字段完全一致（包括大小写）

修正后的MyKey代码：

import java.util.Objects;
import java.io.Serializable;

public class MyKey implements Serializable {
    private int id;
    private int version;

    // 无参构造器
    public MyKey() {}

    // 带参构造器（可选，方便创建实例）
    public MyKey(int id, int version) {
        this.id = id;
        this.version = version;
    }

    // 重写equals和hashCode
    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (o == null || getClass() != o.getClass()) return false;
        MyKey myKey = (MyKey) o;
        return id == myKey.id && version == myKey.version;
    }

    @Override
    public int hashCode() {
        return Objects.hash(id, version);
    }

    // getter和setter方法
    public int getId() { return id; }
    public void setId(int id) { this.id = id; }
    public int getVersion() { return version; }
    public void setVersion(int version) { this.version = version; }
}

3. 补充实体类的必要结构 #

YourEntity类需要添加：

• 无参构造器（JPA必须）
• 主键字段的getter和setter方法（JPA需要访问字段值）

修正后的YourEntity代码：

import jakarta.persistence.Entity;
import jakarta.persistence.Id;
import jakarta.persistence.IdClass;

@Entity
@IdClass(MyKey.class)
public class YourEntity {
    @Id
    private int id;
    @Id
    private int version;

    // 无参构造器
    public YourEntity() {}

    // 带参构造器（可选）
    public YourEntity(int id, int version) {
        this.id = id;
        this.version = version;
    }

    // getter和setter
    public int getId() { return id; }
    public void setId(int id) { this.id = id; }
    public int getVersion() { return version; }
    public void setVersion(int version) { this.version = version; }
}

4. 检查数据库表结构 #

确认数据库中id字段的约束：

• 必须设置为NOT NULL（符合你的需求）
• 字段类型与实体类的int匹配（如MySQL的INT类型）
• 没有设置错误的默认值（比如默认null，虽然int类型一般不会，但需要确认）

5. 确认插入操作的正确性 #

如果使用Spring Data JPA，确保调用save()方法时，传入的是新创建的实体对象，而非从数据库查询出来的对象（否则会触发更新而非插入）。如果使用EntityManager，优先使用persist()方法插入新实体，避免使用merge()（merge()会先查询数据库，可能导致逻辑错误）。

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