Spring Boot 项目启动失败从「程序包不存在」到成功启动完整排查过程项目墨卷阅读平台mojuan-reading-platform技术栈Spring Boot 3.5 MyBatis Maven MySQL开发工具IntelliJ IDEA 2026 Ultimate本文记录了项目启动过程中遇到的一个典型问题以及完整的排查思路和解决过程。一、问题描述项目创建完成后我编写了第一个后端接口BookControllerBookServiceBookMapperBookReadingPlatformServerApplication但是运行项目时IDEA 提示大量错误例如程序包 lombok 不存在 程序包 org.springframework.web.bind.annotation 不存在 程序包 org.apache.ibatis.annotations 不存在 程序包 org.springframework.boot 不存在二、原因查看 IDEA 构建日志发现了一个非常关键的信息编译模块 mojuan-reading-platform而不是reading-platform-server问题就出在这里。项目目录如下mojuan-reading-platform │ ├── docs ├── database ├── reading-platform-server ├── reading-platform-web后续创建 └── README.md整个仓库实际上是一个 Git Repository。真正的 Spring Boot 工程只有reading-platform-server但是 IDEA 在创建项目时将mojuan-reading-platform也当成了一个普通 Java Module。于是运行时流程变成IDEA ↓ 编译 ↓ mojuan-reading-platform ↓ 找不到 Spring Boot 依赖 ↓ 程序包不存在因此所有 Spring、MyBatis、Lombok 包全部报错。三、正确解决方法如果“模块”下拉框里仍然没有 reading-platform-server说明 IDEA 模块配置还没正确导入。这时回到右侧 Maven 面板点击一次“重新加载所有 Maven 项目”再重新打开运行配置。四、感悟本次问题并不是Spring Boot 配置错误Maven 下载失败MyBatis 配置错误Lombok 配置错误真正原因是IDEA 运行时编译了错误的 Module。导致编译器没有使用 Spring Boot 工程中的依赖因此所有 Spring 包全部提示程序包不存在五、总结这次排查最大的收获并不是修复了一个 Bug。而是彻底理解了Git 仓库Maven 工程IDEA ModuleSpring Boot 启动类它们之间的关系。整个启动流程如下Git Repositorymojuan-reading-platform │ ├── docs ├── database ├── reading-platform-server │ └── pom.xml │ ▼ Maven 下载依赖 │ ▼ IDEA 编译 reading-platform-server │ ▼ ReadingPlatformServerApplication │ ▼ Spring Boot 启动 │ ▼ Tomcat8080 │ ▼ REST API经验总结按照下面的顺序排查检查pom.xml是否引入正确依赖。确认 Maven 已成功下载依赖。执行mvn compile验证 Maven 是否能够正常编译。检查 IDEA 是否识别了正确的 Maven Module。检查 Run Configuration 是否使用了正确的模块、工作目录和启动类。按照这个思路大部分 Spring Boot 项目启动阶段的问题都能够快速定位。结语本次踩坑让我真正理解了 Git 仓库、Maven 工程和 IDEA Module 三者的区别。很多看似是 Spring Boot 或 Maven 的问题其实最终都可以归结到 IDEA 的项目结构和运行配置。理解原理比记住操作步骤更重要这也是搭建企业级项目时必须掌握的基础能力。
)
