执行./mvnw spring-boot:run启动Spring Initializr时遇主类缺失错误求助

问题重现 #

执行命令 ./mvnw spring-boot:run 时出现以下错误：

[ERROR] Failed to execute goal org.springframework.boot:spring-boot-maven-plugin:3.3.2:run (default-cli) on project initializr: Unable to find a suitable main class, please add a 'mainClass' property -> [Help 1]
[ERROR]
[ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
[ERROR] Re-run Maven using the -X switch to enable full debug logging.
[ERROR]
[ERROR] For more information about the errors and possible solutions, please read the following articles:
[ERROR] [Help 1] http://cwiki.apache.org/confluence/display/MAVEN/MojoExecutionException

解决方案 #

1. 确认主类存在性 #

检查项目中是否包含带 @SpringBootApplication 注解的主类，标准结构如下：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

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

若缺失，需在项目根包路径下创建该类。

2. 手动配置mainClass属性 #

若主类存在但Maven无法自动识别，在 pom.xml 的Spring Boot插件中指定主类全限定名：

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <configuration>
                <!-- 替换为你的主类完整路径 -->
                <mainClass>com.example.initializr.InitializrApplication</mainClass>
            </configuration>
        </plugin>
    </plugins>
</build>

保存配置后重新执行启动命令。

3. 清理重建项目 #

执行以下命令清理缓存并重新编译项目：

./mvnw clean install

完成后再次运行 ./mvnw spring-boot:run。

4. 校验插件与Spring Boot版本一致性 #

确保 spring-boot-maven-plugin 的版本和项目中Spring Boot依赖版本完全匹配，避免版本不兼容导致的识别异常。

内容的提问来源于stack exchange，提问作者jayaprakash dash