Spring Boot 版本选择与项目初始化实践

本文适合以下读者：

• 正在做课程设计或毕业设计的计算机专业学生
• 刚接触 Spring Boot 的初级 Java 开发者
• 想规范化搭建后端项目结构的同学

主要解决两个实际问题：

1. Spring Boot 版本应该如何选择，避免依赖冲突和环境不兼容
2. 如何从零搭建一个结构规范、后期可扩展的 Spring Boot 项目

我是在 Windows 10 + JDK 8 + MySQL 8 环境下整理和验证本文内容的，相关配置均来自真实项目与教学实践，并非简单整理官方文档。

一、为什么 Spring Boot 版本选择会影响整个项目

不少同学创建项目时，直接使用 IDE 默认版本，能运行就算完成。但在实际开发中，常见问题包括：

• JDK 版本与 Spring Boot 不兼容
• MyBatis、Redis、Swagger 依赖冲突
• 本地可以启动，服务器无法运行
• 打包部署后出现 NoClassDefFoundError

这些问题，大多数并不是代码错误，而是版本组合不合理导致的。

Spring Boot 本质上是一个“依赖管理平台”，核心版本选错，后续整合的技术组件都会受到影响。

二、常用版本组合建议（实测稳定）

1. 不同使用场景推荐方案

对于初学者或学生项目，不建议直接使用 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 创建项目

操作步骤：

1. File → New Project → Spring Initializr

2. 选择：

   • Project：Maven
   • Language：Java
   • Spring Boot：2.7.x

3. 填写 Group 与 Artifact

4. 勾选依赖：

   • 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 个初始化问题

1. 使用 JDK 17 启动 Spring Boot 2.x
2. MySQL 驱动版本过旧导致连接失败
3. 手动指定依赖版本造成冲突
4. Controller 包未被扫描
5. YAML 缩进错误导致配置失效

这些问题在项目中出现频率非常高。