本文适合以下读者：
- 正在做课程设计或毕业设计的计算机专业学生
- 刚接触 Spring Boot 的初级 Java 开发者
- 想规范化搭建后端项目结构的同学
主要解决两个实际问题：
- Spring Boot 版本应该如何选择，避免依赖冲突和环境不兼容
- 如何从零搭建一个结构规范、后期可扩展的 Spring Boot 项目
我是在 Windows 10 + JDK 8 + MySQL 8 环境下整理和验证本文内容的，相关配置均来自真实项目与教学实践，并非简单整理官方文档。
一、为什么 Spring Boot 版本选择会影响整个项目
不少同学创建项目时，直接使用 IDE 默认版本，能运行就算完成。但在实际开发中，常见问题包括：
- JDK 版本与 Spring Boot 不兼容
- MyBatis、Redis、Swagger 依赖冲突
- 本地可以启动，服务器无法运行
- 打包部署后出现 NoClassDefFoundError
这些问题，大多数并不是代码错误，而是版本组合不合理导致的。
Spring Boot 本质上是一个“依赖管理平台”，核心版本选错，后续整合的技术组件都会受到影响。
二、常用版本组合建议（实测稳定）
1. 不同使用场景推荐方案
| 使用场景 | JDK | Spring Boot | 说明 |
|---|---|---|---|
| 课程设计 / 毕业设计 | JDK 8 | 2.6.x – 2.7.x | 资料多，生态成熟 |
| 企业维护项目 | JDK 8 / 11 | 2.6.x / 2.7.x | 兼容性好 |
| 新项目（生产） | JDK 17 | 3.x | Jakarta 体系，迁移成本高 |
对于初学者或学生项目，不建议直接使用 Spring Boot 3.x，因为：
- 包名由 javax 迁移为 jakarta
- 部分第三方组件尚未完全适配
- 学习成本明显提高
2. 推荐具体版本
在多个教学项目与实际项目中，以下组合稳定性较好：
- JDK：1.8.0_202 或以上
- Spring Boot：2.6.13 / 2.7.18
- Maven：3.6.x 及以上
该组合可稳定支持：
- MyBatis / MyBatis-Plus
- Redis
- Spring Security
- JWT
- 常见日志框架
三、项目创建方式（以 IntelliJ IDEA 为例）
使用 Spring Initializr 创建项目
操作步骤：
File → New Project → Spring Initializr
选择：
- Project：Maven
- Language：Java
- Spring Boot：2.7.x
填写 Group 与 Artifact
勾选依赖：
- Spring Web
- MySQL Driver
- MyBatis Framework
创建完成后，先不要急于写业务代码，建议先检查版本与结构是否正确。
四、标准项目目录结构设计
建议使用如下结构：
com.xxx.project ├── controller ├── service ├── service.impl ├── mapper ├── entity ├── config └── common对应资源目录：
resources ├── mapper └── application.yml该结构在课程设计、毕业设计与中小型项目中通用性较强，后期维护成本较低。
五、pom.xml 核心配置说明
父工程统一使用 Spring Boot 官方依赖管理：
<parent><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-parent</artifactId><version>2.7.18</version></parent><properties><java.version>1.8</java.version></properties>常用依赖配置：
<dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency><dependency><groupId>mysql</groupId><artifactId>mysql-connector-j</artifactId><scope>runtime</scope></dependency><dependency><groupId>org.mybatis.spring.boot</groupId><artifactId>mybatis-spring-boot-starter</artifactId><version>2.3.1</version></dependency></dependencies>经验原则：
- 能不手动指定版本就不指定
- 避免多个 Starter 重复引入
六、application.yml 基础配置示例
server:port:8080spring:datasource:url:jdbc:mysql://localhost:3306/test?useSSL=false&serverTimezone=UTCusername:rootpassword:123456driver-class-name:com.mysql.cj.jdbc.Drivermybatis:mapper-locations:classpath:mapper/*.xmltype-aliases-package:com.xxx.project.entity注意：
- YAML 文件使用空格缩进，不要使用 Tab
- MySQL 8 建议显式设置 serverTimezone
七、首次启动检查清单
启动前建议确认：
- JDK 版本是否正确
- 数据库是否已创建
- 端口 8080 是否被占用
- Maven 依赖是否下载完成
启动成功标志：
Started Application in x.xxx seconds八、真实项目中常见的 5 个初始化问题
- 使用 JDK 17 启动 Spring Boot 2.x
- MySQL 驱动版本过旧导致连接失败
- 手动指定依赖版本造成冲突
- Controller 包未被扫描
- YAML 缩进错误导致配置失效
这些问题在项目中出现频率非常高。
