异常教程

springboot mysql 配置（长文解析）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战(已更新的所有项目都能学习) / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

  • 新开坑项目:《Spring AI 项目实战》 正在持续爆肝中，基于 Spring AI + Spring Boot 3.x + JDK 21...， 点击查看 ;
  • 《从零手撸：仿小红书（微服务架构）》 已完结，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;演示链接： http://116.62.199.48:7070 ;
  • 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习 ，欢迎点击围观

在现代 Web 开发领域，Spring Boot 与 MySQL 的组合是构建高性能、高可用性应用的常见选择。Spring Boot 提供了开箱即用的配置简化方案，而 MySQL 作为关系型数据库的代表，以其稳定性和灵活性广受开发者青睐。本文将从零开始讲解如何实现 Spring Boot MySQL 配置，涵盖基础环境搭建、核心配置参数解析、代码集成实践以及常见问题排查，帮助读者快速掌握这一技术栈的整合方法。

一、环境准备与项目搭建

1.1 Spring Boot 项目创建

首先需要创建一个 Spring Boot 项目。推荐使用 Spring Initializr（https://start.spring.io）进行快速搭建。选择以下配置：

  • Project：Maven Project
  • Language：Java 或 Kotlin（本文以 Java 为例）
  • Dependencies：添加 Spring Web 和 Spring Data JPA（用于数据库交互），以及 MySQL 连接驱动。

1.2 添加 MySQL 依赖

在 pom.xml 文件中，需显式添加 MySQL 连接器依赖：

<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.29</version>
</dependency>

注意：MySQL 驱动类名在不同版本中可能变化（如 com.mysql.cj.jdbc.Driver），需与版本对应。

1.3 安装与配置 MySQL

安装 MySQL 后，创建一个测试数据库（例如 test_db），并设置用户名和密码。可通过命令行或工具（如 MySQL Workbench）执行以下操作：

CREATE DATABASE test_db;
CREATE USER 'springuser'@'localhost' IDENTIFIED BY 'springpass';
GRANT ALL PRIVILEGES ON test_db.* TO 'springuser'@'localhost';
FLUSH PRIVILEGES;

二、Spring Boot 配置 MySQL 的核心步骤

2.1 配置数据库连接参数

在 Spring Boot 的 application.properties 或 application.yml 文件中，需声明数据库连接信息。以下以 application.properties 为例：

spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
spring.datasource.url=jdbc:mysql://localhost:3306/test_db?useSSL=false&serverTimezone=Asia/Shanghai
spring.datasource.username=springuser
spring.datasource.password=springpass

关键参数解释：

  • useSSL=false：禁用 SSL 连接（适用于测试环境，生产环境需谨慎配置）。
  • serverTimezone：解决时区不一致问题，避免 Invalid default value 等错误。

表格：Spring Boot 数据源配置参数对照表

（与前文空一行）
| 参数名称 | 作用描述 | 示例值 |
|-------------------------|------------------------------------------|----------------------------------|
| driver-class-name | 指定 JDBC 驱动类名 | com.mysql.cj.jdbc.Driver |
| url | 数据库连接地址 | jdbc:mysql://localhost:3306/test_db |
| username | 数据库访问用户名 | springuser |
| password | 数据库访问密码 | springpass |

2.2 配置连接池（HikariCP）

Spring Boot 默认使用 HikariCP 作为连接池，可通过以下参数优化性能：

spring.datasource.hikari.maximum-pool-size=10  # 最大连接数  
spring.datasource.hikari.minimum-idle=5        # 最小空闲连接数  
spring.datasource.hikari.connection-timeout=30000 # 连接超时时间（毫秒）

比喻：连接池就像“水管管理站”，预先准备好多个连接（水管），避免每次请求都重新开凿新水管，从而提升效率。

三、代码集成与实体映射

3.1 创建实体类（Entity）

定义一个用户实体类 User，并使用 JPA 注解映射到数据库表：

import javax.persistence.*;

@Entity
@Table(name = "users")
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    
    @Column(name = "name", nullable = false)
    private String name;
    
    @Column(name = "email", unique = true)
    private String email;
    
    // 省略 getter/setter 方法
}

关键注解说明：

  • @Entity：标记该类为 JPA 实体类。
  • @Table：指定数据库表名（默认与类名一致）。
  • @Id：标识主键字段。

3.2 编写 Repository 接口

通过继承 JpaRepository 实现数据库操作：

import org.springframework.data.jpa.repository.JpaRepository;

public interface UserRepository extends JpaRepository<User, Long> {
    // 可添加自定义查询方法（如 findByEmail）  
}

优势：Spring Data JPA 自动生成 CRUD 方法，如 save()、findAll() 等。

3.3 服务层与控制层集成

在 Service 层调用 Repository，最终通过 Controller 提供 REST 接口：

// UserService.java
@Service
public class UserService {
    private final UserRepository userRepository;
    
    @Autowired
    public UserService(UserRepository userRepository) {
        this.userRepository = userRepository;
    }
    
    public User createUser(User user) {
        return userRepository.save(user);
    }
}

// UserController.java
@RestController
@RequestMapping("/users")
public class UserController {
    private final UserService userService;
    
    @Autowired
    public UserController(UserService userService) {
        this.userService = userService;
    }
    
    @PostMapping
    public User addNewUser(@RequestBody User user) {
        return userService.createUser(user);
    }
}

四、高级配置与性能优化

4.1 事务管理

通过 @Transactional 注解实现事务控制，确保数据一致性：

@Service
public class UserService {
    @Transactional
    public void transferFunds(User from, User to, double amount) {
        from.setBalance(from.getBalance() - amount);
        to.setBalance(to.getBalance() + amount);
        userRepository.save(from);
        // 如果此处抛出异常，所有操作将回滚
    }
}

比喻：事务如同“银行转账”，要么全额完成，要么完全撤销，避免出现“半途而废”的中间状态。

4.2 SQL 日志输出

启用 SQL 日志以调试查询语句：

spring.jpa.show-sql=true  
spring.jpa.properties.hibernate.format_sql=true

五、常见问题与解决方案

5.1 连接失败：Communications link failure

可能原因：MySQL 服务未运行、端口被占用或防火墙拦截。
解决方法：

  1. 检查 MySQL 服务状态：systemctl status mysql。
  2. 确认 spring.datasource.url 中的端口（默认 3306）。

5.2 驱动类未找到：No suitable driver found

可能原因：依赖未正确引入，或驱动类名拼写错误。
解决方法：

  • 验证 pom.xml 中的 MySQL 驱动依赖是否有效。
  • 对比版本对应的驱动类名（如 MySQL 8.x 使用 com.mysql.cj.jdbc.Driver）。

5.3 SQL 语法错误：Unknown column '...' in 'field list'

可能原因：实体类字段与数据库表结构不匹配。
解决方法：

  • 使用 spring.jpa.hibernate.ddl-auto=update 自动同步表结构（仅限开发环境）。
  • 手动执行 DROP TABLE 和重新创建表。

六、实践案例：用户管理系统

6.1 数据库表创建

执行 SQL 脚本创建 users 表：

CREATE TABLE users (
    id BIGINT AUTO_INCREMENT PRIMARY KEY,
    name VARCHAR(50) NOT NULL,
    email VARCHAR(100) UNIQUE NOT NULL
);

6.2 完整代码示例

通过上述配置与代码，启动 Spring Boot 应用后，可通过 Postman 发送 POST 请求：

POST http://localhost:8080/users  
Content-Type: application/json  

{
    "name": "Alice",
    "email": "alice@example.com"
}

成功响应将返回新增用户的详细信息，验证配置与代码的正确性。

结论

本文系统讲解了从零到一实现 Spring Boot MySQL 配置 的全流程，涵盖环境搭建、核心配置、代码集成、性能优化及问题排查。通过实际案例的演示，读者可快速上手并应用于实际项目。建议读者在实践中结合以下要点：

  1. 配置参数的版本适配性：不同 MySQL 版本的驱动类与连接参数可能不同。
  2. 连接池的合理配置：根据业务需求调整连接池大小，避免资源浪费或不足。
  3. 事务边界划分：明确事务范围，确保业务逻辑的原子性。

掌握这些技能后，开发者可以更高效地构建基于 Spring Boot 与 MySQL 的企业级应用。

最新发布

查看更多文章