无法修改实体时，如何避免Hibernate创建唯一约束

方案1：通过Hibernate MetadataContributor动态移除约束 #

Hibernate允许通过自定义MetadataContributor在元数据构建阶段修改列的约束配置，无需改动原实体类：

import org.hibernate.boot.Metadata;
import org.hibernate.boot.spi.MetadataContributor;
import org.hibernate.mapping.Column;
import org.hibernate.mapping.Component;
import org.hibernate.mapping.PersistentClass;

public class UniqueConstraintRemover implements MetadataContributor {
    @Override
    public void contribute(Metadata metadata) {
        // 遍历所有持久化类
        for (PersistentClass persistentClass : metadata.getEntityBindings()) {
            // 检查嵌入类（@Embeddable）
            for (Object property : persistentClass.getPropertyClosureIterator()) {
                if (property instanceof Component component) {
                    // 找到目标列
                    Column personIdColumn = component.getColumn("PERSON_ID");
                    if (personIdColumn != null) {
                        // 移除唯一约束
                        personIdColumn.setUnique(false);
                    }
                }
            }
        }
    }
}

然后在Spring测试配置中注册这个Contributor：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.orm.hibernate5.LocalSessionFactoryBean;

import java.util.Properties;

@Configuration
public class TestHibernateConfig {
    @Bean
    public LocalSessionFactoryBean sessionFactory() {
        LocalSessionFactoryBean sessionFactory = new LocalSessionFactoryBean();
        // 配置数据源、实体扫描路径等原有配置...
        Properties hibernateProps = new Properties();
        // 注册自定义MetadataContributor
        hibernateProps.put("hibernate.metadata_contributors", UniqueConstraintRemover.class.getName());
        sessionFactory.setHibernateProperties(hibernateProps);
        return sessionFactory;
    }
}

方案2：自定义DB-Rider表创建策略 #

DB-Rider支持自定义TableCreator，可以在表创建后删除不需要的唯一约束：

import com.github.database.rider.core.api.configuration.DBUnit;
import com.github.database.rider.core.configuration.DBUnitConfig;
import com.github.database.rider.core.dataset.TableCreator;
import com.github.database.rider.core.dataset.TableCreatorImpl;
import org.dbunit.database.IDatabaseConnection;

import java.sql.SQLException;

public class CustomTableCreator extends TableCreatorImpl {
    @Override
    public void createTables(IDatabaseConnection connection, DBUnitConfig config) throws SQLException {
        // 先执行默认建表逻辑
        super.createTables(connection, config);
        // 删除目标唯一约束（注意约束名需匹配数据库自动生成的名称，比如H2会生成类似UK_xxx_PERSON_ID的格式）
        connection.getConnection().createStatement().execute(
            "ALTER TABLE your_target_table DROP CONSTRAINT UK_xxx_PERSON_ID"
        );
    }
}

然后在测试类上指定自定义TableCreator：

@DBUnit(tableCreator = CustomTableCreator.class)
public class YourTestClass {
    // 测试方法...
}

方案3：使用预定义SQL脚本跳过自动建表 #

直接在测试中使用手动编写的建表SQL（移除唯一约束），禁用Hibernate的自动建表：

1. 在src/test/resources下创建schema.sql，内容为：

CREATE TABLE your_target_table (
    PERSON_ID BIGINT NOT NULL,
    -- 其他列定义...
    PRIMARY KEY (PERSON_ID) -- 仅当该列是主键时保留，否则删除此行
);

2. 在Spring测试配置文件（application-test.properties）中添加参数：

spring.jpa.hibernate.ddl-auto=none
spring.sql.init.mode=always
spring.sql.init.schema-locations=classpath:schema.sql

这样Hibernate不会自动生成表结构，而是使用你提供的SQL脚本，避免创建错误的唯一约束。

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