Maven多父项目下Spring Boot实体层复用架构咨询

我完全理解你的困惑——Maven的单父项目限制确实会让跨父项目复用代码有点棘手，但其实咱们只需要调整一下项目结构，把共享的实体层抽成独立模块就能完美解决。

核心思路：抽离独立的共享模块 #

不要把ProjectEntity放在任何一个父项目的子模块里，而是单独创建一个独立的Maven模块（比如叫project-common），专门存放所有需要跨项目复用的代码：实体类、通用DTO、枚举、工具类等等。然后让你的两个父项目（ProjectAPIParent和ProjectClientUIParent）各自的业务模块去依赖这个共享模块。

具体项目结构示例 #

your-workspace/
├── project-common/          # 独立共享模块，存放ProjectEntity等
│   ├── src/
│   │   └── main/java/com/yourcompany/project/entity/ProjectEntity.java
│   └── pom.xml
├── ProjectAPIParent/
│   ├── pom.xml              # API父项目的pom
│   └── ProjectAPI/          # API业务子模块
│       ├── src/
│       └── pom.xml          # 依赖project-common
└── ProjectClientUIParent/
    ├── pom.xml              # UI父项目的pom
    └── ProjectClientUI/     # UI业务子模块
        ├── src/
        └── pom.xml          # 依赖project-common

Maven配置细节 #

1. project-common的pom.xml：这个模块不需要依赖任何业务父项目，只需要引入必要的基础依赖（比如JPA API、Lombok等）：

<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.yourcompany</groupId>
    <artifactId>project-common</artifactId>
    <version>1.0.0-SNAPSHOT</version>
    <packaging>jar</packaging>

    <dependencies>
        <!-- JPA API，用于实体类注解 -->
        <dependency>
            <groupId>jakarta.persistence</groupId>
            <artifactId>jakarta.persistence-api</artifactId>
            <version>3.1.0</version>
            <scope>provided</scope>
        </dependency>
        <!-- 如果用Lombok简化实体类 -->
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <version>1.18.30</version>
            <optional>true</optional>
        </dependency>
    </dependencies>
</project>

2. 在ProjectAPI中引入依赖：在ProjectAPI的pom.xml里添加对project-common的依赖：

<dependencies>
    <!-- 引入共享实体模块 -->
    <dependency>
        <groupId>com.yourcompany</groupId>
        <artifactId>project-common</artifactId>
        <version>1.0.0-SNAPSHOT</version>
    </dependency>
    <!-- 其他Spring Boot、Hibernate等依赖 -->
</dependencies>

3. 在ProjectClientUI中引入依赖：同样，在ProjectClientUI的pom.xml里添加相同的依赖配置，就能直接使用ProjectEntity了。

为什么这是最优方案？ #

• 单一职责：共享模块只负责通用代码，业务模块专注于各自的业务逻辑，符合SOLID原则。
• 避免重复：ProjectEntity只需要维护一份，不会出现两个父项目中实体类不一致的问题。
• 符合Maven规范：利用Maven的依赖管理机制，完美规避了子项目不能有多个父项目的限制。
• 扩展性强：后续如果有更多项目需要复用这些实体，只需要引入这个共享模块即可。

如果你的两个父项目本身有一些通用的配置（比如Spring Boot版本、依赖管理），也可以考虑创建一个顶级父项目，让project-common、ProjectAPIParent、ProjectClientUIParent都继承这个顶级父项目，这样能进一步统一依赖版本管理，但这是可选的，核心还是共享模块的抽离。

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