唯一约束的艺术：@Column(unique=true) vs. @Table(uniqueConstraints)，你用对了吗？

🔑 唯一约束的艺术：@Column(unique=true) vs. @Table(uniqueConstraints)，你用对了吗？

你好，我是坚持哥！在数据库设计中，唯一约束 (Unique Constraint) 是确保数据完整性的基石。它保证了表中某一列或某几列的组合值是唯一的，不允许重复。在 Spring Boot 和 JPA (Java Persistence API) 的世界里，我们通常通过注解来定义这些约束。

然而，你是否曾遇到过这样的尴尬：明明只想定义一个唯一约束，生成的 DDL (Data Definition Language) 却出现了重复的约束定义？或者，你对何时使用 @Column(unique = true)，何时使用 @Table(uniqueConstraints = { @UniqueConstraint(...) }) 感到困惑？🤔

今天，我将带你深入探索这两种定义唯一约束的方式，揭示它们各自的适用场景和背后的原理，帮助你彻底掌握唯一约束的艺术，让你的数据库设计更加规范、整洁！🚀

📝 两种唯一约束定义方式速览

场景引入：用户表的唯一性

在我的福利小程序项目中，用户表 (SolutionUser) 需要保证以下字段的唯一性：

• open_id (微信 OpenID - Open Identification)：用户在小程序内的唯一标识。
• union_id (微信 UnionID - Union Identification)：用户在微信开放平台下的唯一标识。
• phone (手机号)：用户的手机号。

这些都是单个字段的唯一性约束。

🗺️ 错误与修正：重复约束的“尴尬”

最初，我可能在 SolutionUser 实体中同时使用了两种方式来定义 open_id 的唯一性：

// SolutionUser.java (错误示例)
@Column(name = "open_id", unique = true) // 方式一
private String openId;

@Table(name = "solution_user", uniqueConstraints = {
    @UniqueConstraint(columnNames = {"open_id"}) // 方式二
})
public class SolutionUser extends BaseEntity { ... }

结果，JPA 在自动生成 DDL 时，就出现了重复的唯一约束定义：

-- DDL 错误示例
create table solution_user (
    -- ...
    constraint UK_random_string_open_id unique (open_id), -- 来自 @Column(unique=true)
    constraint UK_solution_user_open_id unique (open_id), -- 来自 @UniqueConstraint
    -- ...
);

🗺️ 设计流程：唯一约束的正确姿势

为了避免这种重复，并遵循最佳实践，我们应该只选择其中一种方式来定义唯一约束。

🤝 交互时序：JPA 如何生成唯一约束？

💻 唯一约束的正确姿势：代码示例

根据“单个字段唯一用 @Column(unique=true)，联合唯一用 @Table(uniqueConstraints)”的原则，SolutionUser 实体应该这样定义：

// SolutionUser.java (最终正确版本)
package com.productQualification.user.domain;

import com.productQualification.common.entity.BaseEntity;
import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;
import lombok.EqualsAndHashCode;
import lombok.ToString;

import javax.persistence.*;
import java.util.Date;
import java.util.HashSet;
import java.util.Set;

@ApiModel(description = "福利方案-客户用户表")
@Entity
@Table(name = "solution_user") // <-- 移除 @Table 上的 uniqueConstraints
@Data
@EqualsAndHashCode(callSuper = true, exclude = "collections")
@ToString(callSuper = true, exclude = "collections")
public class SolutionUser extends BaseEntity {

    @ApiModelProperty("微信OpenID，用户在小程序内的唯一标识")
    @Column(name = "open_id", length = 100, nullable = false, unique = true) // <-- 保持 unique = true
    private String openId;

    @ApiModelProperty("微信UnionID，用户在开放平台下的唯一标识（跨小程序、公众号）")
    @Column(name = "union_id", length = 100, unique = true) // <-- 保持 unique = true
    private String unionId;

    @ApiModelProperty("用户所属的管理员ID（店铺ID），用于数据隔离")
    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "admin_id", nullable = false)
    private Admin admin;

    @ApiModelProperty("用户微信昵称")
    @Column(name = "nickname", length = 50)
    private String nickname;

    @ApiModelProperty("用户微信头像URL")
    @Column(length = 255)
    private String avatar;

    @ApiModelProperty("用户手机号")
    @Column(length = 20, unique = true) // <-- 保持 unique = true
    private String phone;

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

🧠 总结思维导图

最后，用一张思维导图来总结唯一约束的艺术。

希望通过这篇文章，你对 JPA 中唯一约束的定义有了更清晰的认识。掌握这些细节，将让你的数据库设计更加规范、整洁！Happy coding! 🎉