当前位置：首页 > news >正文

Spring Boot 集成 MySQL 的详细指南

news 2025/12/16 14:27:14

在现代软件开发中，Spring Boot 因其简单易用而成为构建 Java 应用程序的热门选择。结合 MySQL这一常用关系型数据库，开发者可以快速构建出功能完善的后端服务。本文将详细介绍如何将 Spring Boot 与 MySQL 集成，提供从环境搭建到代码实现的全方位指导。

一、环境准备

在开始之前，请确保你已经具备以下环境：

JDK: Java Development Kit (JDK) 8 及以上版本。
Maven: 用于管理项目和依赖。
MySQL: 已安装并可访问的 MySQL 数据库。
IDE: 安装的 Java 集成开发环境，如 IntelliJ IDEA 或 Eclipse。

1.1 安装 MySQL

如果你还没有安装 MySQL，可以通过以下链接获取：MySQL Downloads

安装完成后，使用命令行或 MySQL Workbench 创建一个新的数据库，例如 test_db。

CREATE DATABASE test_db;

二、创建 Spring Boot 项目

2.1 使用 Spring Initializr 创建项目

访问 Spring Initializr，选择以下配置项：
- Project: Maven Project
- Language: Java
- Spring Boot: 选择最新的稳定版本
- Packaging: Jar
- Java: 选择相应版本
在 Dependencies 中添加：
- Spring Web
- Spring Data JPA
- MySQL Driver
生成项目，并下载压缩包，解压后在 IDE 中打开。

2.2 项目结构

解压后的项目结构如下：

src
└── main├── java│   └── com│       └── example│           └── demo│               ├── DemoApplication.java│               └── ...└── resources├── application.properties└── ...

三、配置 MySQL 数据库连接

打开 application.properties 文件，添加以下配置：

spring.datasource.url=jdbc:mysql://localhost:3306/test_db?useSSL=false&allowPublicKeyRetrieval=true
spring.datasource.username=root
spring.datasource.password=your_password
spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true

3.1 配置详解

spring.datasource.url: 数据库连接 URL，包含数据库名 test_db。
spring.datasource.username: 数据库用户，默认是 root。
spring.datasource.password: 数据库用户的密码。
spring.jpa.hibernate.ddl-auto: 自动创建或更新数据库表。
spring.jpa.show-sql: 显示执行的 SQL 语句，方便调试。

四、创建实体类

在 com.example.demo 包下创建一个实体类 User 代表 users 表：

package com.example.demo;import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;@Entity
public class User {@Id@GeneratedValue(strategy = GenerationType.IDENTITY)private Long id;private String name;private String email;// Getters and Setterspublic Long getId() {return id;}public void setId(Long id) {this.id = id;}public String getName() {return name;}public void setName(String name) {this.name = name;}public String getEmail() {return email;}public void setEmail(String email) {this.email = email;}
}

五、创建数据访问层

接下来，我们需要创建一个接口来访问数据库，通常使用 Spring Data JPA 进行数据访问。

在 com.example.demo 包下创建一个接口 UserRepository：

package com.example.demo;import org.springframework.data.jpa.repository.JpaRepository;public interface UserRepository extends JpaRepository<User, Long> {// 这里可以添加自定义查询方法
}

六、创建服务层

创建一个服务类来管理用户的业务逻辑。

在 com.example.demo 包下创建 UserService 类：

package com.example.demo;import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;import java.util.List;@Service
public class UserService {@Autowiredprivate UserRepository userRepository;public List<User> getAllUsers() {return userRepository.findAll();}public User createUser(User user) {return userRepository.save(user);}public User getUserById(Long id) {return userRepository.findById(id).orElse(null);}public void deleteUser(Long id) {userRepository.deleteById(id);}
}

七、创建控制器

最后，我们需要一个控制器来处理 HTTP 请求。在 com.example.demo 包下创建 UserController 类：

package com.example.demo;import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;import java.util.List;@RestController
@RequestMapping("/api/users")
public class UserController {@Autowiredprivate UserService userService;@GetMappingpublic List<User> getAllUsers() {return userService.getAllUsers();}@PostMappingpublic User createUser(@RequestBody User user) {return userService.createUser(user);}@GetMapping("/{id}")public ResponseEntity<User> getUserById(@PathVariable Long id) {User user = userService.getUserById(id);return ResponseEntity.ok(user);}@DeleteMapping("/{id}")public ResponseEntity<Void> deleteUser(@PathVariable Long id) {userService.deleteUser(id);return ResponseEntity.noContent().build();}
}

八、测试与运行

8.1 测试数据库连接

在项目根目录下，运行以下命令以启动应用程序：

mvn spring-boot:run

确认你的 MySQL 数据库已启动，并且能够在 localhost:3306 访问。

8.2 使用 Postman 测试 API

获取所有用户: 发送 GET 请求到 http://localhost:8080/api/users
创建用户: 发送 POST 请求到 http://localhost:8080/api/users，并在正文中包含 JSON 数据，例如：

{"name": "John Doe","email": "john.doe@example.com"
}

获取用户: 发送 GET 请求到 http://localhost:8080/api/users/{id}
删除用户: 发送 DELETE 请求到 http://localhost:8080/api/users/{id}

九、总结

恭喜你！现在你已经成功地将 Spring Boot 应用程序与 MySQL 数据库集成。本文涵盖了从环境搭建、项目创建到代码实现的多个方面，希望能帮助你快速上手开发基于 Spring Boot 的 Web 应用。

9.1 后续学习

掌握更多的 Spring Data JPA 特性，如复杂查询和分页。
学习如何进行异常处理和输入验证。
探索 Spring Security 来保护 REST API。
学习如何部署 Spring Boot 应用到云服务。

希望本文能够为你后续的开发之路提供帮助。如果你有任何问题或建议，请随时联系我！