多租户Spring应用：如何指定部分实体不生成数据库表？

你可以通过以下几种方案实现需求，既保留主数据库的spring.jpa.hibernate.ddl-auto配置，又阻止跨库实体在主库生成表：

方案一：配置多数据源分离实体管理 #

这是最清晰可靠的方案，将主库实体与跨库实体分别绑定到不同的数据源，各自独立配置DDL策略：

1. 配置多数据源信息 #

在application.yml（或properties）中定义主数据源和跨库数据源：

spring:
  datasource:
    main:
      url: jdbc:mysql://localhost:3306/main_db
      username: root
      password: your_main_pwd
      driver-class-name: com.mysql.cj.jdbc.Driver
    cross:
      url: jdbc:mysql://localhost:3306/cross_db
      username: root
      password: your_cross_pwd
      driver-class-name: com.mysql.cj.jdbc.Driver

2. 主数据源配置类 #

负责扫描主库实体和Repository，保留原有DDL配置：

@Configuration
@EnableJpaRepositories(
    basePackages = "com.yourproject.repository.main",
    entityManagerFactoryRef = "mainEntityManagerFactory",
    transactionManagerRef = "mainTransactionManager"
)
@EntityScan(basePackages = "com.yourproject.entity.main")
public class MainDataSourceConfig {

    @Primary
    @Bean
    @ConfigurationProperties(prefix = "spring.datasource.main")
    public DataSource mainDataSource() {
        return DataSourceBuilder.create().build();
    }

    @Primary
    @Bean
    public LocalContainerEntityManagerFactoryBean mainEntityManagerFactory(EntityManagerFactoryBuilder builder) {
        return builder
                .dataSource(mainDataSource())
                .packages("com.yourproject.entity.main")
                .persistenceUnit("mainPU")
                .properties(getHibernateProps("update")) // 填入你原有的ddl-auto值
                .build();
    }

    @Primary
    @Bean
    public PlatformTransactionManager mainTransactionManager(EntityManagerFactory mainEntityManagerFactory) {
        return new JpaTransactionManager(mainEntityManagerFactory);
    }

    private Map<String, Object> getHibernateProps(String ddlAuto) {
        Map<String, Object> props = new HashMap<>();
        props.put("hibernate.hbm2ddl.auto", ddlAuto);
        // 添加你原有的其他Hibernate配置，比如方言等
        props.put("hibernate.dialect", "org.hibernate.dialect.MySQL8Dialect");
        return props;
    }
}

3. 跨库数据源配置类 #

负责扫描跨库实体和Repository，禁用DDL操作：

@Configuration
@EnableJpaRepositories(
    basePackages = "com.yourproject.repository.cross",
    entityManagerFactoryRef = "crossEntityManagerFactory",
    transactionManagerRef = "crossTransactionManager"
)
@EntityScan(basePackages = "com.yourproject.entity.cross")
public class CrossDataSourceConfig {

    @Bean
    @ConfigurationProperties(prefix = "spring.datasource.cross")
    public DataSource crossDataSource() {
        return DataSourceBuilder.create().build();
    }

    @Bean
    public LocalContainerEntityManagerFactoryBean crossEntityManagerFactory(EntityManagerFactoryBuilder builder) {
        return builder
                .dataSource(crossDataSource())
                .packages("com.yourproject.entity.cross")
                .persistenceUnit("crossPU")
                .properties(getHibernateProps("none"))
                .build();
    }

    @Bean
    public PlatformTransactionManager crossTransactionManager(EntityManagerFactory crossEntityManagerFactory) {
        return new JpaTransactionManager(crossEntityManagerFactory);
    }

    private Map<String, Object> getHibernateProps(String ddlAuto) {
        Map<String, Object> props = new HashMap<>();
        props.put("hibernate.hbm2ddl.auto", ddlAuto);
        props.put("hibernate.dialect", "org.hibernate.dialect.MySQL8Dialect");
        return props;
    }
}

这种方式完全隔离了两个数据源的实体管理，主库正常执行DDL，跨库实体不会触发任何DDL操作。

方案二：自定义Hibernate元数据贡献者跳过指定实体 #

如果不想配置多数据源，可以通过自定义Hibernate的MetadataContributor，在元数据处理阶段移除跨库实体，阻止其DDL生成：

1. 实现自定义贡献者 #

public class SkipCrossEntityDdlContributor implements MetadataContributor {

    // 填写你需要跳过的跨库实体全类名
    private final Set<String> skipEntities = Set.of(
        "com.yourproject.entity.cross.CrossEntityA",
        "com.yourproject.entity.cross.CrossEntityB"
    );

    @Override
    public void contribute(Metadata metadata, StandardServiceRegistry serviceRegistry) {
        metadata.getEntityBindings().removeIf(binding -> 
            skipEntities.contains(binding.getEntityName())
        );
    }
}

2. 注册贡献者 #

在application.yml中添加配置：

spring:
  jpa:
    properties:
      hibernate.metadata_contributors: com.yourproject.config.SkipCrossEntityDdlContributor

注意：这种方法需要准确指定实体类名，若实体存在关联关系可能引发元数据异常，适合简单场景。

方案三：为跨库实体指定目标数据库Schema/Catalog #

如果你的数据库支持跨库访问（如MySQL的Schema等价于数据库），可以在跨库实体上指定目标库，让Hibernate的DDL操作指向目标库而非主库：

@Entity
@Table(name = "cross_table", catalog = "cross_db") // 指定跨库的catalog
@Immutable // 标记为只读，避免意外修改
public class CrossEntity {
    // 实体字段与映射
}

同时确保主数据源的数据库用户拥有访问cross_db的权限，Hibernate会在cross_db中检查表结构（而非主库），主库不会生成该实体的表。

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