Spring Boot 项目启动报错 “找不到或无法加载主类” 解决笔记

一、问题描述

在使用 IntelliJ IDEA 开发基于 Spring Boot 框架的 Java 程序时,原本项目能够正常启动。但在后续编写代码并重建项目后,再次尝试运行却出现了 "错误:找不到或无法加载主类 com.example.springboot.SpringbootApplication" 的错误提示。

二、排查过程

  1. Maven 配置检查 :查看项目 settings 中的 Maven 版本及配置路径,确认是否指向了正确的本地 Maven 安装目录。若配置有误,可能导致 Maven 无法正确解析项目依赖及构建文件,进而找不到主类。经检查,我的配置正确,此方法未能解决问题。


  2. 端口号检查:考虑到端口号被占用可能引发启动异常,尝试修改项目的运行端口号。然而,修改后问题依旧存在,说明端口占用并非此次错误的根源。

  3. 断点清理 :使用快捷键(Ctrl+Shift+F8)打开 Breakpoints 窗口,或通过工具栏 run -> view Breakpoints... ,将所有断点选项取消勾选后点击 Done。目的是排除因断点设置不当干扰程序正常启动的可能性,但该操作未解决找不到主类的问题。

三、解决方案

通过使用 Maven 命令行的方式最后成功解决了该问题,具体执行的命令如下:

  1. 清理并编译项目 :在项目根目录下打开命令行窗口,执行mvn clean compile命令。此命令先清理之前构建生成的文件,再重新编译项目源代码,确保生成最新的字节码文件。若编译过程中存在错误,会在命令行输出详细信息,方便定位和修复。

  2. 安装项目到本地仓库 :执行mvn install命令,将项目构建产物安装到本地 Maven 仓库。这一步确保项目依赖的完整性以及项目自身构件在本地仓库的正确存储,为后续运行提供保障。

  3. 运行 Spring Boot 应用 :最后执行mvn spring-boot:run命令,该命令直接启动 Spring Boot 应用程序。此次成功启动项目,解决了 "找不到或无法加载主类" 的问题。

    mvn clean compile

    mvn install

    mvn spring-boot:run

注意哈,如果使用cmd命令行,需要在含pom.xml的文件目录下操作,如果提示'mvn' 不是内部或外部命令,也不是可运行的程序 或批处理文件。需要配置环境变量:将Maven的bin目录添加到系统的PATH环境变量中。

相关推荐
郑州光合科技余经理8 分钟前
家政O2O平台解析:从0搭建上门预约小程序解决方案
android·java·开发语言·前端·小程序·架构·php
耀耀_很无聊30 分钟前
13_Spring Boot 3.5.8 + Redisson 3.45.1 导致 Sa-Token 登录 StackOverflowError
spring boot·后端·bootstrap
AskHarries35 分钟前
邮件发送方案对比
后端
野蛮人6号37 分钟前
黑马天机学堂系列问题之域名无法正常使用
java·spring cloud·天机学堂
学计算机的计算基39 分钟前
回溯算法下篇:四道经典题讲透约束剪枝、原地标记、预计算与状态压缩
java·笔记·算法
Ai拆代码的曹操43 分钟前
@Async 注解失效的底层真相:this 调用绕过代理,接口响应翻倍
后端
l134062082351 小时前
HarmonyOS应用开发实战:小事记 - 多媒体文件上传:@ohos.net.http 的 multipart/form-data 请求构造
后端·华为·harmonyos·鸿蒙系统
小小猪的春天1 小时前
AI Code Review 例外决策框架:手动忽略警告之前,先回答4个问题
后端·架构
大卫陈1 小时前
微信小程序虚拟支付实战:从「支付能力被限制」到沙箱调通的全过程
前端·后端
武子康1 小时前
vLLM 0.25.1:服务没有报错,为什么仍会生成垃圾 Token(5 级正确性门禁 + 自动回滚条件)
前端·人工智能·后端