Maven多模块Spring Boot项目多@SpringBootApplication类处理方案咨询

当多模块Spring Boot项目存在多个标注@SpringBootApplication的主启动类时，Maven Spring Boot插件无法自动确定唯一入口，就会抛出Unable to find a single main class from the following candidates错误。以下是几种实用的处理方案：

1. 运行命令直接指定主类 #

临时启动某个应用时，直接在Maven命令中通过参数指定要启动的主类全限定名：

# 启动OrganigramaApplication
mvn spring-boot:run -Dspring-boot.run.main-class=com.yourpackage.OrganigramaApplication

# 启动TreeAppApplication
mvn spring-boot:run -Dspring-boot.run.main-class=com.yourpackage.TreeAppApplication

这种方式无需修改项目配置，适合快速测试不同的启动入口。

2. 在pom.xml中配置默认主类 #

如果某个主类是日常开发的常用入口，可以在对应模块的pom.xml中配置Spring Boot插件的默认主类：

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <configuration>
                <!-- 指定默认启动的主类 -->
                <mainClass>com.yourpackage.OrganigramaApplication</mainClass>
            </configuration>
        </plugin>
    </plugins>
</build>

需要切换启动类时，修改mainClass的值即可。如果是父模块配置，子模块可以通过覆盖该配置来指定自己的主类。

3. 调整模块架构（最佳实践） #

多模块Spring Boot项目的标准设计中，建议仅保留一个启动模块：

• 将其中一个@SpringBootApplication类所在的模块作为独立的启动模块（比如命名为xxx-app或xxx-boot），负责应用启动和配置加载。
• 另一个主类如果属于独立的应用场景，将其拆分到新的子模块中，各自维护自己的启动配置和依赖。
• 其他业务代码（如service、dao、utils等）拆分为通用依赖模块，供启动模块引入。

这种架构能清晰划分模块职责，从根源避免多主类冲突，也符合Spring Boot项目的分层设计规范。

4. 结合Profiles区分启动（特殊场景） #

如果必须在同一模块保留多个主类，可以通过Spring Profiles标记不同的启动类，启动时激活对应Profile：
修改主类代码：

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

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

启动时同时指定主类和Profile：

mvn spring-boot:run -Dspring-boot.run.main-class=com.yourpackage.OrganigramaApplication -Dspring.profiles.active=organigrama

内容的提问来源于stack exchange，提问作者MARIO JOSE BARRERA LINAREZ