JPA持久化Product实体触发唯一约束冲突错误求助

1. 实体类重复定义id字段导致映射混乱 #

你的Product类继承了AbstractEntity，而AbstractEntity又继承了AbstractPersistable<Long>——这个父类已经内置了id字段，并且实现了实体isNew()的判断逻辑。但你在Product类中又重新定义了private Long id;并添加@Id、@GeneratedValue注解，这会导致JPA处理标识符时出现冲突：

• 即使你调试时看到子类的id为null，父类的id可能被意外赋值，或者标识符生成策略无法正确绑定到实际插入的字段
• @AttributeOverride本应覆盖父类id的列映射，但子类重复定义id字段会让该注解失效，最终JPA无法正确使用IDENTITY策略生成主键

解决方法：
删除Product类中自行定义的id字段，依赖父类的id字段，通过注解调整映射和生成策略：

@Entity
@Table(name = "products")
@Getter
@Setter
@NoArgsConstructor
@AllArgsConstructor
@AttributeOverride(name = "id", column = @Column(name = "product_id"))
@EqualsAndHashCode(callSuper = false)
public class Product extends AbstractEntity<Long> {
    
    // 移除自行定义的id字段
    
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Override
    public Long getId() {
        return super.getId();
    }

    // 其余字段保持不变...
}

同时给AbstractEntity添加@MappedSuperclass注解，确保父类字段被正确映射：

@MappedSuperclass
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public abstract class AbstractEntity<ID extends Serializable> extends AbstractPersistable<ID> {

    @Override
    public void setId(ID id) {
        super.setId(id);
    }
}

2. PostgreSQL自增序列与表中现有数据不同步 #

如果曾通过原生SQL手动向products表插入过数据（比如插入了product_id=2的记录），但PostgreSQL的自增序列（默认名称为products_product_id_seq）的当前值未同步更新，那么JPA通过IDENTITY策略生成主键时，序列会输出已存在的id值，导致主键冲突。

验证方法：
执行SQL查看序列当前值：

SELECT last_value FROM products_product_id_seq;

若返回的last_value小于表中最大的product_id，说明序列不同步。

解决方法：
更新序列当前值为表中最大的product_id：

SELECT setval('products_product_id_seq', (SELECT MAX(product_id) FROM products));

额外检查点 #

• 确认调用productsRepository.save()时传入的是全新实体，避免误将从数据库查询出的托管实体（即使手动设id为null）当作新实体保存
• 排查是否有AOP、拦截器等代码在保存前给实体id赋值

内容的提问来源于stack exchange，提问作者Miguel Ángel Cantarero Ortega