如何实现含@OneToMany与复合主键的JPA实体增改操作

1. 关联实体的级联配置缺失 #

当前MaterialEntity中的@OneToMany注解未配置级联操作，当插入/更新主实体时，若携带了materialImageEntityList集合，JPA无法自动处理关联子实体的持久化/更新，直接导致操作失败。

修改代码，添加级联规则及孤儿移除属性：

@OneToMany(cascade = CascadeType.ALL, orphanRemoval = true)
@JoinColumn(name="material_id")
private List<MaterialImageEntity> materialImageEntityList;

• cascade = CascadeType.ALL：让主实体的插入、更新、删除操作级联到子实体
• orphanRemoval = true：当子实体从集合中移除时，自动删除数据库中对应的记录，避免脏数据

2. 复合主键实体的equals/hashCode未正确实现 #

MaterialImageEntity使用了复合主键，但必须确保对应的MaterialImageCompositePrimaryKeyEntity正确实现equals()和hashCode()方法，否则JPA无法正确识别实体唯一性，导致关联操作异常。

示例实现：

public class MaterialImageCompositePrimaryKeyEntity implements Serializable {
    private Integer materialId;
    private Integer imageId;

    // 构造函数、Getter、Setter

    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (o == null || getClass() != o.getClass()) return false;
        MaterialImageCompositePrimaryKeyEntity that = (MaterialImageCompositePrimaryKeyEntity) o;
        return Objects.equals(materialId, that.materialId) && Objects.equals(imageId, that.imageId);
    }

    @Override
    public int hashCode() {
        return Objects.hash(materialId, imageId);
    }
}

3. JPA审计功能未开启 #

@CreatedDate、@LastModifiedDate等审计字段需要Spring Data JPA审计功能支持才能自动填充值，若未开启，可能因字段值为null触发数据库非空约束导致操作失败。

• 在Spring配置类上添加@EnableJpaAuditing注解开启审计
• 若需自动填充createdBy、updatedBy，需实现AuditorAware<Integer>接口并注入Spring容器

4. 数据库约束冲突 #

• 检查material表字段约束：确认category_id、unit_id等字段是否允许null，若实体中对应属性为null但数据库设置为NOT NULL，会触发插入失败
• 检查material_image表外键约束：插入子实体时，确保主实体已完成持久化（或通过级联操作自动处理），避免外键关联失败

5. 事务上下文缺失 #

JPA的插入/更新操作必须在事务上下文内执行，确保执行操作的方法被@Transactional注解修饰，否则持久化操作不会生效或抛出异常。

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