如何使用Ebean为元素集合添加唯一约束

问题本质 #

用@ElementCollection关联@Embeddable类时，在@CollectionTable里声明包含关联外键（role_id）的组合唯一约束，Ebean会因为嵌入类的特殊解析逻辑，无法正确生成这个约束。但把嵌入类改成实体类就正常，是因为实体类的约束解析逻辑更直接，不会忽略外键字段。

有效解决方案 #

方案1：调整注解配置，强制Ebean识别约束

修改集合表的约束声明，明确约束名称，同时给嵌入类的字段指定列名并配合@DbConstraint：

@ElementCollection
@CollectionTable(
    schema = "participants",
    joinColumns = @JoinColumn(name = "role_id"),
    uniqueConstraints = {
        @UniqueConstraint(
            name = "uk_role_integration_tag",
            columnNames = {"role_id", "integration_tag"}
        )
    }
)
private final List<DefaultAccount> defaultIntegrationAccounts = new ArrayList<>();

嵌入类调整：

@Embeddable
public class DefaultAccount {
    @NotNull
    @Column(name = "integration_tag")
    @DbConstraint(unique = false) // 避免单独生成字段的唯一约束，配合集合表的组合约束
    private final String integrationTag;

    @NotNull
    @ManyToOne
    @JoinColumn(name = "account_id") // 显式指定外键列，消除自动生成的歧义
    private Account account;

    // 构造方法、getter/setter 保持原样
}

方案2：手动在数据库添加约束（兜底方案）

如果注解方式还是不生效，直接在数据库层面创建组合唯一约束：

ALTER TABLE participants.default_integration_accounts
ADD CONSTRAINT uk_role_integration_tag UNIQUE (role_id, integration_tag);

代码里保留@UniqueConstraint注解作为文档，方便后续迁移时同步约束。

验证方法 #

启动应用后检查数据库表的约束列表，确认uk_role_integration_tag存在；或者尝试插入重复的role_id+integration_tag组合数据，看是否触发唯一键冲突异常。

内容的提问来源于stack exchange，提问作者João Mendes