如何将基于自定义Archetype的多模块Maven项目转为Spring Boot结构？

核心Maven配置改造步骤 #

针对单项目的改造逻辑可复用为批量处理的基础：

• 替换父POM：将原有自定义父POM替换为Spring Boot官方父POM，统一依赖版本管理

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.7.15</version> <!-- 选择适配业务的稳定版本 -->
    <relativePath/>
</parent>

• 调整模块依赖：给作为Spring Boot应用入口的模块（如web服务模块）添加对应starter依赖，其他依赖模块无需添加starter，仅需保证依赖版本与Spring Boot兼容

<!-- 示例：web模块添加web starter -->
<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
</dependencies>

• 引入Spring Boot打包插件：在启动模块的build节点中添加插件，用于生成可执行JAR包

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <version>2.7.15</version>
            <executions>
                <execution>
                    <goals>
                        <goal>repackage</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

• 迁移配置文件：将原有配置文件（如*.properties/*.xml）迁移到Spring Boot标准路径src/main/resources/，并重命名为application.properties或application.yml，自定义配置可通过@PropertySource注解指定
• 添加启动类：在启动模块中创建带有@SpringBootApplication注解的主类，作为应用入口

@SpringBootApplication
public class AppStarter {
    public static void main(String[] args) {
        SpringApplication.run(AppStarter.class, args);
    }
}

批量处理自动化方案 #

针对100+项目的场景，推荐以下自动化手段：

• 脚本批量修改：编写Shell/Python脚本，遍历所有项目目录，通过文本替换工具（如sed）批量修改POM文件，复制启动类模板到指定模块，自动迁移配置文件。例如用sed替换父POM节点、插入插件依赖
• 自定义Maven插件：开发专属Maven插件，封装POM修改、启动类生成、配置迁移等逻辑，在所有项目的父POM中引入该插件，执行mvn clean install时自动完成改造
• 基于改造后模板批量生成：先手动完成一个项目的改造，基于该项目生成新的Spring Boot Archetype，再通过该Archetype批量生成项目结构，最后用脚本将原有项目的业务代码复制到对应目录

关键注意事项 #

• 依赖冲突排查：改造后执行mvn dependency:tree检查依赖冲突，针对冲突依赖在POM中通过<dependencyManagement>锁定版本
• 模块职责明确：确保仅一个模块作为Spring Boot启动模块，其余模块为普通依赖模块，避免多启动入口问题
• 批量验证：改造完成后抽取典型项目执行mvn clean package并启动验证，确保功能正常

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