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
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驱动 -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<scope>runtime</scope>
</dependency>
<!-- MyBatis集成 -->
<dependency>
<groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
<version>2.1.4</version>
</dependency>
<!-- 测试支持 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
</dependencies>
2.2.2 application.yml配置
YAML格式的配置文件更加清晰易读，主要配置项包括：
yaml复制server:
port: 8082 # 服务端口
spring:
datasource:
url: jdbc:mysql://localhost:3306/ssm?useUnicode=true&characterEncoding=utf-8&useSSL=true&serverTimezone=UTC
username: root
password: 123456
driver-class-name: com.mysql.cj.jdbc.Driver
mybatis:
mapper-locations: classpath*:mapper/**/*Mapper.xml # 映射文件位置
type-aliases-package: com.guo.demo.domain # 实体类包路径
注意：数据库连接参数需要根据你的实际环境进行调整。特别是useSSL参数，在生产环境中应该设置为true并配置正确的证书。
3. 数据库设计与实现
3.1 数据表设计
我们设计一个学生信息表，包含以下字段：
- id：主键，自增
- name：学生姓名
- age：学生年龄
- gender：性别
- student_no：学号（唯一）
- major：专业
- create_time：创建时间
- update_time：更新时间
SQL脚本如下：
sql复制CREATE TABLE student (
id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '学生ID',
name VARCHAR(50) NOT NULL COMMENT '学生姓名',
age INT NOT NULL COMMENT '学生年龄',
gender VARCHAR(10) NOT NULL COMMENT '学生性别',
student_no VARCHAR(20) UNIQUE NOT NULL COMMENT '学号',
major VARCHAR(50) COMMENT '专业',
create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
update_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间'
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='学生信息表';
3.2 实体类映射
对应的Java实体类如下：
java复制package com.guo.demo.domain;
import java.util.Date;
public class Student {
private Long id;
private String name;
private Integer age;
private String gender;
private String studentNo;
private String major;
private Date createTime;
private Date updateTime;
// 省略getter和setter方法
}
开发技巧：使用Lombok可以简化实体类的编写，通过@Getter和@Setter注解自动生成getter/setter方法。但在本教程中，我们保持最基础的形式以便理解。
4. 数据访问层实现
4.1 Mapper接口设计
MyBatis的Mapper接口定义了数据访问的方法：
java复制@Repository
public interface StudentMapper {
List<Student> selectAll();
Student selectById(Long id);
Student selectByStudentNo(String studentNo);
int insert(Student student);
int update(Student student);
int deleteById(Long id);
}
4.2 XML映射文件
对应的Mapper XML文件实现了具体的SQL：
xml复制<mapper namespace="com.guo.demo.mapper.StudentMapper">
<resultMap id="BaseResultMap" type="com.guo.demo.domain.Student">
<id column="id" property="id"/>
<result column="name" property="name"/>
<result column="age" property="age"/>
<result column="gender" property="gender"/>
<result column="student_no" property="studentNo"/>
<result column="major" property="major"/>
<result column="create_time" property="createTime"/>
<result column="update_time" property="updateTime"/>
</resultMap>
<select id="selectAll" resultMap="BaseResultMap">
SELECT * FROM student ORDER BY id DESC
</select>
<!-- 其他SQL语句省略 -->
</mapper>
经验分享：在resultMap中明确指定列名和属性名的映射关系，可以避免因命名风格不同（如下划线vs驼峰）导致的数据映射失败问题。
5. 业务逻辑层实现
5.1 Service接口设计
业务逻辑接口定义了服务层的能力：
java复制public interface StudentService {
List<Student> getAllStudents();
Student getStudentById(Long id);
Student createStudent(Student student);
Student updateStudent(Long id, Student student);
void deleteStudent(Long id);
}
5.2 Service实现类
具体的业务逻辑实现：
java复制@Service
public class StudentServiceImpl implements StudentService {
@Autowired
private StudentMapper studentMapper;
@Override
public List<Student> getAllStudents() {
return studentMapper.selectAll();
}
@Override
public Student createStudent(Student student) {
// 实际开发中应该先校验学号是否已存在
studentMapper.insert(student);
return studentMapper.selectById(student.getId());
}
// 其他方法实现省略
}
重要提示：在实际项目中，createStudent方法应该先检查学号是否已存在，避免数据重复。这里为了简化示例省略了这部分逻辑。
6. 控制器层实现
6.1 RESTful API设计
我们按照RESTful风格设计学生信息的API：
java复制@RestController
@RequestMapping("/api/students")
public class StudentController {
@Autowired
private StudentService studentService;
@GetMapping
public List<Student> getAllStudents() {
return studentService.getAllStudents();
}
@PostMapping
public Student createStudent(@RequestBody Student student) {
return studentService.createStudent(student);
}
// 其他端点省略
}
6.2 启动类配置
别忘了在启动类上添加Mapper扫描注解：
java复制@SpringBootApplication
@MapperScan("com.guo.demo.mapper")
public class Demo18Application {
public static void main(String[] args) {
SpringApplication.run(Demo18Application.class, args);
}
}
7. 接口测试与验证
7.1 查询所有学生
GET请求：
code复制http://localhost:8082/api/students/
响应示例：
json复制[
{
"id": 1,
"name": "张三",
"age": 20,
"gender": "男",
"studentNo": "2023001",
"major": "计算机科学",
"createTime": "2024-03-15T08:00:00",
"updateTime": "2024-03-15T08:00:00"
}
]
7.2 创建新学生
POST请求：
code复制http://localhost:8082/api/students/
请求体：
json复制{
"name": "李四",
"age": 22,
"gender": "女",
"studentNo": "2023004",
"major": "人工智能"
}
7.3 常见问题排查
-
数据库连接失败：
- 检查application.yml中的数据库配置
- 确认MySQL服务已启动
- 验证用户名和密码是否正确
-
MyBatis映射失败：
- 检查Mapper接口和XML文件的namespace是否一致
- 确认resultMap中的属性映射是否正确
- 查看启动类是否添加了@MapperScan注解
-
端口冲突：
- 如果8082端口被占用，可以在application.yml中修改server.port
8. 项目优化建议
虽然我们已经实现了一个完整的CRUD功能，但在实际项目中还可以进行以下优化：
-
统一响应格式：
- 使用Result类封装响应数据，包含状态码、消息和实际数据
- 示例：
java复制public class Result<T> { private int code; private String message; private T data; // 构造方法和getter/setter }
-
异常处理：
- 创建全局异常处理器
- 对不同的异常类型返回适当的错误信息
-
参数校验：
- 使用Hibernate Validator进行参数校验
- 在实体类字段上添加注解如@NotBlank、@Size等
-
分页查询：
- 集成PageHelper实现分页功能
- 在查询接口中添加pageNum和pageSize参数
-
日志记录：
- 添加Slf4j日志
- 记录重要的业务操作和异常信息
9. 开发心得与经验分享
在实际开发Spring Boot项目时，我总结了以下几点经验：
-
版本兼容性：
- Spring Boot、JDK和数据库驱动版本之间的兼容性非常重要
- 建议使用Spring Boot官方推荐的版本组合
-
配置管理：
- 将不同环境的配置分开（application-dev.yml, application-prod.yml）
- 使用@Profile注解指定环境特定的配置
-
接口设计：
- RESTful接口应该使用复数名词（如/students而不是/student）
- 合理使用HTTP状态码（200成功，400客户端错误，500服务器错误）
-
MyBatis使用技巧：
- 对于复杂的查询，可以使用@Select注解直接在接口上编写SQL
- 动态SQL可以使用
、 等标签实现
-
调试技巧：
- 开启MyBatis的SQL日志：在application.yml中添加
yaml复制logging: level: com.guo.demo.mapper: debug - 使用Postman或Swagger进行接口测试
- 开启MyBatis的SQL日志：在application.yml中添加
这个项目虽然简单，但涵盖了Spring Boot开发的完整流程。希望这篇教程能帮助你快速上手Spring Boot开发。在实际项目中，你可能还需要考虑更多因素，如安全性、性能优化、分布式事务等，这些都可以在掌握基础后逐步学习。