Spring Boot多模块下依赖控数据库时新增JPA实体的实现方案

核心思路 #

既然核心模块用Liquibase管控数据库结构且无法修改，那就在第二个模块里单独配置一套独立的Liquibase变更逻辑来创建辅助实体对应的表，同时正常定义JPA实体即可，完全不用动核心模块的代码。

具体步骤 #

1. 给第二个模块配置独立的Liquibase实例 #

在第二个模块的application.yml（或application.properties）里新增一套和核心模块隔离的Liquibase配置：

# 核心模块的Liquibase配置（继承自依赖模块，无需修改）
spring:
  liquibase:
    enabled: true
    change-log: classpath:db/changelog/core-changelog.xml
  # 新增第二个模块专属的Liquibase配置
  liquibase:
    auxiliary:
      enabled: true
      # 指定第二个模块自己的变更日志文件路径
      change-log: classpath:db/changelog/auxiliary-changelog.xml
      # 可选：设置独立上下文，避免和核心模块变更集冲突
      contexts: auxiliary-only

如果用properties格式，对应配置为spring.liquibase.auxiliary.enabled=true等。

2. 编写第二个模块的Liquibase变更日志 #

在第二个模块的src/main/resources/db/changelog目录下创建auxiliary-changelog.xml，写入创建辅助表的变更集：

<?xml version="1.0" encoding="UTF-8"?>
<databaseChangeLog
        xmlns="http://www.liquibase.org/xml/ns/dbchangelog"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog
        http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-4.9.xsd">

    <changeSet id="create_auxiliary_table_1.0" author="your-team">
        <createTable tableName="auxiliary_entity">
            <column name="id" type="BIGINT" autoIncrement="true">
                <constraints primaryKey="true" nullable="false"/>
            </column>
            <column name="biz_key" type="VARCHAR(64)">
                <constraints nullable="false"/>
            </column>
            <column name="extend_info" type="TEXT"/>
            <column name="create_time" type="TIMESTAMP" defaultValueComputed="CURRENT_TIMESTAMP"/>
            <!-- 按需添加其他字段 -->
        </createTable>
    </changeSet>
</databaseChangeLog>

根据你的辅助实体字段调整表结构即可。

3. 正常定义JPA实体和Repository #

在第二个模块里创建辅助实体，确保表名和Liquibase脚本里的完全一致：

import jakarta.persistence.*;
import java.time.LocalDateTime;

@Entity
@Table(name = "auxiliary_entity") // 必须和Liquibase中的表名对应
public class AuxiliaryEntity {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @Column(name = "biz_key", nullable = false)
    private String bizKey;

    @Column(name = "extend_info")
    private String extendInfo;

    @Column(name = "create_time")
    private LocalDateTime createTime;

    // getter、setter、构造方法按需编写
}

再创建对应的Repository：

import org.springframework.data.jpa.repository.JpaRepository;

public interface AuxiliaryEntityRepository extends JpaRepository<AuxiliaryEntity, Long> {
    // 按需添加自定义查询方法
}

4. 确保Spring能扫描到第二个模块的实体 #

如果第二个模块的实体/Repository不在Spring默认扫描路径里，在第二个模块的启动类（或配置类）上添加扫描注解：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.autoconfigure.domain.EntityScan;
import org.springframework.data.jpa.repository.config.EnableJpaRepositories;

@SpringBootApplication
@EntityScan("com.your.company.aux.entity") // 你的辅助实体包路径
@EnableJpaRepositories("com.your.company.aux.repository") // 你的Repository包路径
public class AuxiliaryModuleApplication {
    public static void main(String[] args) {
        SpringApplication.run(AuxiliaryModuleApplication.class, args);
    }
}

可行性说明 #

Spring Boot原生支持多Liquibase实例配置，每个模块可以拥有独立的变更日志和配置，互不干扰。这种方式既遵循了项目用Liquibase管理数据库结构的规范，又完全满足“不修改核心模块”的限制。

内容的提问来源于stack exchange，提问作者Дмитрий Бабанин