如何配置Hibernate仅为带@Table(schema="...")的实体生成DDL？

针对你使用Spring Boot + Hibernate 6+ + PostgreSQL的场景，要实现仅为显式声明@Table(schema = "xxx")的实体生成数据表，可以通过以下两种方案实现：

方案一：Spring Boot 实体扫描过滤（推荐） #

利用Spring Boot的@EntityScan搭配自定义过滤器，只注册符合条件的实体，从根源上阻止无Schema实体被Hibernate处理。

步骤1：创建自定义实体过滤器 #

import org.springframework.core.type.classreading.MetadataReader;
import org.springframework.core.type.classreading.MetadataReaderFactory;
import org.springframework.core.type.filter.TypeFilter;
import jakarta.persistence.Table;
import java.io.IOException;

public class SchemaRequiredEntityFilter implements TypeFilter {
    @Override
    public boolean match(MetadataReader metadataReader, MetadataReaderFactory metadataReaderFactory) throws IOException {
        // 检查实体是否带有@Table注解且schema属性非空
        Table tableAnnotation = metadataReader.getAnnotationMetadata().getAnnotation(Table.class);
        return tableAnnotation != null && !tableAnnotation.schema().isEmpty();
    }
}

步骤2：配置启动类的实体扫描 #

在Spring Boot启动类上添加@EntityScan，指定实体包路径并应用自定义过滤器：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.autoconfigure.domain.EntityScan;
import org.springframework.boot.autoconfigure.domain.EntityScan.Filter;
import org.springframework.core.type.filter.FilterType;

@SpringBootApplication
@EntityScan(
        basePackages = "com.yourproject.entity", // 替换为你的实体包路径
        includeFilters = @Filter(type = FilterType.CUSTOM, classes = SchemaRequiredEntityFilter.class)
)
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

方案二：自定义Hibernate Integrator #

直接通过Hibernate的扩展接口，在元数据构建阶段移除无Schema的实体绑定，阻止DDL生成。

步骤1：实现Hibernate Integrator #

import org.hibernate.boot.Metadata;
import org.hibernate.integrator.spi.Integrator;
import org.hibernate.service.spi.SessionFactoryServiceRegistry;
import jakarta.persistence.Table;
import java.util.ArrayList;
import java.util.List;

public class SchemaRequiredIntegrator implements Integrator {
    @Override
    public void integrate(Metadata metadata, SessionFactoryServiceRegistry sessionFactoryServiceRegistry) {
        List<String> entitiesToRemove = new ArrayList<>();
        // 遍历所有实体绑定，筛选出无Schema的实体
        metadata.getEntityBindings().forEach(binding -> {
            Class<?> entityClass = binding.getMappedClass().getJavaType();
            Table tableAnnotation = entityClass.getAnnotation(Table.class);
            if (tableAnnotation == null || tableAnnotation.schema().isEmpty()) {
                entitiesToRemove.add(binding.getEntityName());
            }
        });
        // 移除不符合条件的实体
        entitiesToRemove.forEach(metadata::removeEntityBinding);
    }

    @Override
    public void disintegrate(SessionFactoryServiceRegistry sessionFactoryServiceRegistry) {
        // 无需实现销毁逻辑
    }
}

步骤2：注册Integrator #

在application.properties中添加配置：

hibernate.integrator_provider=com.yourproject.integrator.SchemaRequiredIntegrator

或者通过Spring配置类注册：

import org.hibernate.jpa.boot.spi.IntegratorProvider;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import java.util.Collections;

@Configuration
public class HibernateConfig {
    @Bean
    public IntegratorProvider integratorProvider() {
        return () -> Collections.singletonList(new SchemaRequiredIntegrator());
    }
}

注意事项 #

1. 两种方案都能实现需求，方案一更贴合Spring Boot生态，配置更简洁；方案二直接操作Hibernate底层元数据，适合需要更精细控制的场景。
2. 确保@Table的schema属性不是默认空字符串（Hibernate中@Table.schema()的默认值为空串，所以过滤器逻辑中会排除这类实体）。

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