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环境变量中。

相关推荐
葫芦和十三29 分钟前
图解 MongoDB 21|选举与 failover:Primary 是怎么选出来的
后端·mongodb·agent
GetcharZp1 小时前
26k Star 开源内网穿透神器 NetBird,一分钟实现全球设备互联!
后端
考虑考虑2 小时前
Mybatis实现批量插入
java·后端·mybatis
咖啡八杯2 小时前
GoF设计模式——中介者模式
java·后端·spring·设计模式
lizhongxuan5 小时前
多Agent之间的区别
后端
青石路6 小时前
记一次多JDK版本问题的排查,一坑套一坑,差点没爬上来
java
杨充7 小时前
1.面向对象设计思想
后端
IT_陈寒7 小时前
Java的Date类又坑了我一次,改用时间戳真香
前端·人工智能·后端
systemPro7 小时前
2.6亿条设备数据,历史查询从超时到50ms,我做了什么
后端
要阿尔卑斯吗8 小时前
提示词优化启示:为什么“按顺序输出“比“关键度评分“更有效
后端