无法运行单体项目内的SpringBoot模块：右键无Run选项且IDE找不到主类

1. 确认项目结构与IDE依赖刷新 #

• 检查父项目构建文件：
  • Maven：父pom.xml中需包含<modules>标签列出所有子项目，且父pom的<packaging>类型为pom。
  • Gradle：根settings.gradle中需通过include 'module-name'声明所有子模块。
• 刷新IDE依赖：Maven点击工具栏「Reload All Maven Projects」，Gradle点击「Reload All Gradle Projects」，让IDE重新识别模块关系。

2. 直接运行子项目的主类 #

父项目本身不是SpringBoot应用，因此右键父项目不会出现「Run Project」选项，正确操作是：

• 定位到子项目中带有@SpringBootApplication注解的主类（通常命名为XxxApplication）。
• 右键该类，选择「Run 'XxxApplication'」直接启动子项目。

3. 修复IDE无法识别主类的问题 #

若IDE找不到主类，检查子项目的构建配置：

• Maven子项目pom.xml：
  1. 必须继承spring-boot-starter-parent：

     <parent>
         <groupId>org.springframework.boot</groupId>
         <artifactId>spring-boot-starter-parent</artifactId>
         <version>你的SpringBoot版本号</version>
     </parent>
     

  2. 需配置spring-boot-maven-plugin插件：

     <build>
         <plugins>
             <plugin>
                 <groupId>org.springframework.boot</groupId>
                 <artifactId>spring-boot-maven-plugin</artifactId>
             </plugin>
         </plugins>
     </build>
     

• Gradle子项目build.gradle：
  1. 应用SpringBoot相关插件：

     plugins {
         id 'org.springframework.boot' version '你的SpringBoot版本号'
         id 'io.spring.dependency-management' version '对应依赖管理版本号'
         id 'java'
     }
     

4. 命令行兜底启动方式 #

如果IDE操作仍失败，直接在父项目根目录打开终端执行命令：

• Maven启动指定子项目：

  mvn spring-boot:run -pl 子项目模块名
  

• Gradle启动指定子项目：

  # Linux/Mac环境
  ./gradlew :子项目模块名:bootRun
  # Windows环境
  gradlew.bat :子项目模块名:bootRun
  

内容的提问来源于stack exchange，提问作者Alexsander Martins