SpringBoot项目JPA注解配置多列唯一约束不生效如何解决

配置失效核心原因 #

• 字段级注解冲突：你在srNo、rollNo两个字段的@Column注解上单独配置了unique = true，这会给两个字段分别创建单列唯一约束，和联合唯一的需求完全冲突。
• 联合约束字段逻辑错误：你的id字段配置了GenerationType.IDENTITY自增主键策略，每次插入数据都会生成全局唯一的新id值。把自增id放进联合唯一约束后，只要id不同，哪怕sr_no.和roll_no完全重复，三个字段的组合值也必然唯一，约束永远不会触发拦截。
• 表结构未同步：如果表是提前手动创建的，仅修改实体类注解没有同步更新数据库表结构，约束不会生效。

正确配置方式 #

1. 移除字段上多余的单列唯一配置：删除srNo、rollNo字段@Column注解中的unique = true属性。
2. 调整联合约束字段范围：如果业务要求sr_no.和roll_no的组合全局唯一（绝大多数业务场景下自增主键不需要参与联合唯一），就把id从联合约束的字段列表中移除；如果确实需要id参与联合唯一，必须去掉id的自增配置，保证id是可重复的业务字段。
3. 修正实体类注解，建议给唯一约束指定自定义名称方便后续维护，参考代码如下：

@Entity
@Table(name = "Student_Master", uniqueConstraints = {
        @UniqueConstraint(name = "uk_stu_sr_roll", columnNames = {"sr_no.", "roll_no"})
})
public class StudentMaster implements Serializable{
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Column(name = "id")
    private Integer sId;

    @Column(name = "sr_no.", length = 5, nullable = false)
    private Integer srNo;

    @Column(name = "roll_no", length = 10, nullable = false)
    private Integer rollNo;

    // 省略其余属性、getter/setter、构造方法
}

4. 同步数据库表结构：如果使用JPA自动建表，确保配置文件中spring.jpa.hibernate.ddl-auto=update；如果是手动管理表结构，需要手动执行DDL添加对应联合唯一约束。

额外注意点 #

• @UniqueConstraint中columnNames填写的值必须和对应字段@Column注解的name属性完全一致，比如你的srNo字段映射列名是sr_no.带后缀点，配置时不能漏写字符。
• 联合唯一约束是数据库层面的兜底校验，建议在业务代码层提前做重复值校验，避免直接抛出数据库异常影响接口体验。

内容的提问来源于stack exchange，提问作者Impulse International School