1. 项目概述与环境准备
在2024年的Java开发环境中,Spring Boot依然是构建企业级应用的首选框架。本文将基于IDEA 2024.1版本,详细演示如何从零开始搭建一个完整的Spring Boot项目,并实现对学生信息的增删改查(CRUD)功能。这个教程特别适合刚接触Spring Boot的开发者,我会分享在实际开发中积累的经验技巧,帮助大家避开常见的坑。
1.1 开发环境要求
在开始之前,请确保你的开发环境满足以下要求:
- IDEA版本:2024.1(社区版或旗舰版均可)
- JDK版本:1.8(注意Spring Boot 2.x与JDK 1.8的兼容性)
- 构建工具:Maven 3.6.3
- 数据库:MySQL 8.x
重要提示:如果你使用的是Spring Boot 3.x版本,必须使用JDK 17或更高版本。本文选择Spring Boot 2.6.13版本是为了兼容JDK 1.8环境。
1.2 项目初始化步骤
在IDEA中创建Spring Boot项目的正确姿势:
- 点击"File → New → Project"
- 选择"Spring Initializr"
- 配置项目基本信息时,Server URL建议使用阿里云镜像:
https://start.aliyun.com/(这样可以避免Java 8选项缺失的问题) - 填写项目基本信息:
- Name: demo18
- Type: Maven
- JDK: 1.8
- Java: 8
- Packaging: Jar
- 在依赖选择界面,勾选"Spring Web"
- 点击"Create"完成项目创建
创建完成后,建议立即检查Maven配置是否正确。我遇到过很多新手因为Maven配置不当导致项目无法构建的问题。可以通过以下步骤验证:
- 打开IDEA设置(Preferences/Settings)
- 搜索"Maven"
- 确认"Maven home path"指向正确的Maven安装目录
- 检查"User settings file"是否配置了正确的settings.xml
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 项目结构与核心配置
2.1 项目目录结构解析
一个标准的Spring Boot项目应该具有如下结构:
code复制src/
├── main/
│ ├── java/
│ │ └── com.guo.demo/
│ │ ├── Demo18Application.java # 启动类
│ │ ├── controller/ # 控制器层
│ │ ├── domain/ # 实体类
│ │ ├── mapper/ # 数据访问层
│ │ └── service/ # 业务逻辑层
│ └── resources/
│ ├── application.yml # 配置文件
│ └── mapper/ # MyBatis映射文件
└── test/ # 测试代码
2.2 关键配置文件详解
2.2.1 pom.xml依赖管理
项目的核心依赖包括:
- spring-boot-starter-web:提供Web开发支持
- mysql-connector-java:MySQL数据库驱动
- mybatis-spring-boot-starter:MyBatis集成
xml复制<dependencies>
<!-- Web支持 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<!-- MySQL驱动 -->
<depen
