Spring Boot子项目拆分-优快云博客

本文链接：https://blog.youkuaiyun.com/Tracycoder/article/details/149048906

1. 按业务模块拆分（推荐）

项目结构示例：

parent-project/
├── pom.xml (父POM)
├── common/                    # 公共模块
│   ├── pom.xml
│   └── src/main/java/
├── user-service/             # 用户服务模块
│   ├── pom.xml
│   └── src/main/java/
├── order-service/            # 订单服务模块
│   ├── pom.xml
│   └── src/main/java/
├── payment-service/          # 支付服务模块
│   ├── pom.xml
│   └── src/main/java/
└── gateway/                  # 网关模块
    ├── pom.xml
    └── src/main/java/

父POM配置示例：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0">
    <modelVersion>4.0.0</modelVersion>
    
    <groupId>com.example</groupId>
    <artifactId>parent-project</artifactId>
    <version>1.0.0</version>
    <packaging>pom</packaging>
    
    <modules>
        <module>common</module>
        <module>user-service</module>
        <module>order-service</module>
        <module>payment-service</module>
        <module>gateway</module>
    </modules>
    
    <properties>
        <spring-boot.version>3.2.0</spring-boot.version>
        <java.version>17</java.version>
    </properties>
    
    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-dependencies</artifactId>
                <version>${spring-boot.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>
</project>

2. 按技术层次拆分

项目结构：

project/
├── api/                      # API接口层
├── service/                  # 业务服务层
├── repository/               # 数据访问层
├── domain/                   # 领域模型层
└── infrastructure/           # 基础设施层

3. 微服务架构拆分

独立服务示例：

services/
├── user-service/             # 用户服务
├── order-service/            # 订单服务
├── inventory-service/        # 库存服务
├── notification-service/     # 通知服务
└── api-gateway/             # API网关

最佳实践建议：

1. 模块职责清晰

每个模块应该有明确的职责边界
避免循环依赖
遵循单一职责原则

2. 依赖管理

<!-- 子模块POM示例 -->
<parent>
    <groupId>com.example</groupId>
    <artifactId>parent-project</artifactId>
    <version>1.0.0</version>
</parent>

<artifactId>user-service</artifactId>
<dependencies>
    <dependency>
        <groupId>com.example</groupId>
        <artifactId>common</artifactId>
        <version>${project.version}</version>
    </dependency>
</dependencies>

3. 包结构规范

com.example.userservice/
├── controller/              # 控制器层
├── service/                 # 业务逻辑层
├── repository/              # 数据访问层
├── entity/                  # 实体类
├── dto/                     # 数据传输对象
└── config/                  # 配置类

4. 配置管理

# application.yml
spring:
  profiles:
    active: dev
  application:
    name: user-service

# 模块特定配置
user-service:
  database:
    url: jdbc:mysql://localhost:3306/user_db

5. 版本管理

<properties>
    <project.version>1.0.0</project.version>
    <spring-boot.version>3.2.0</spring-boot.version>
    <mysql.version>8.0.33</mysql.version>
</properties>