如何通过JPA/Hibernate为MySQL表配置多列唯一复合索引

JPA标准注解原生支持多列组合唯一约束配置，配置完成后会自动在数据库层创建对应的联合唯一索引，同时满足你「四个字段组合全局唯一」的约束要求和高频查询的性能优化需求，不需要额外引入其他实现。

具体配置方式 #

直接在实体类的@Table注解中添加uniqueConstraints配置即可，修改后的实体类代码如下：

@Data
@Entity
@SuperBuilder
@NoArgsConstructor
@AllArgsConstructor
@Table(
    name = "loan",
    uniqueConstraints = {
        @UniqueConstraint(
            name = "uk_loan_amount_rate_payments_pmt",
            columnNames = {"amount", "rate", "payments", "pmt"}
        )
    }
)
public class Loan {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Column(name = "loan_id", unique = true, nullable = false)
    private long id;

    @Column(name = "amount", nullable = false)
    private double amount;

    @Column(name = "rate", nullable = false)
    private double rate;

    @Column(name = "payments", nullable = false)
    private int payments;

    @Column(name = "pmt", nullable = false)
    private double pmt;
}

配置说明 #

• 上述配置是JPA标准用法，Hibernate会在生成表结构时自动创建对应的联合唯一索引，数据库层面会强制校验四个字段的组合唯一性，出现重复组合的写入请求时会直接抛出约束违反异常，完全实现你需要的类复合键约束效果。
• 你日常执行的四字段等值查询刚好完全覆盖该联合索引的所有列，查询时可以直接走索引匹配，不需要额外为这几个字段创建单独的普通索引。
• 配置时注意columnNames里要填数据库实际列名（也就是@Column注解的name属性值），不要填Java实体类的字段名，避免索引建错列。
• 建议给唯一约束设置明确的自定义名称，后续排查约束冲突报错时，可以直接通过约束名定位问题，不用识别框架自动生成的随机约束名。

注意事项 #

不建议使用double/float这类浮点数类型作为唯一约束的判定字段。浮点数存储存在精度误差问题，可能出现业务逻辑上判定为相等的两个值，实际数据库存储的二进制内容存在细微差异，导致唯一约束误判、漏判。涉及金额、利率这类需要精确等值匹配的字段，建议将Java类型改为BigDecimal，对应数据库的DECIMAL类型，从根源避免精度问题。

如果是已经上线的存量表，不要只修改注解就直接发布，需要手动执行DDL语句创建对应唯一索引，避免框架没有自动更新表结构导致约束不生效，对应SQL参考：

ALTER TABLE loan ADD UNIQUE INDEX uk_loan_amount_rate_payments_pmt (amount, rate, payments, pmt);

当写入操作触发唯一约束冲突时，Spring Data JPA会抛出DataIntegrityViolationException，在业务层捕获该异常做重复数据的对应提示处理即可。

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