Spring Boot + MyBatis-Plus 快速连接 MySQL

关注

原创最新推荐文章于 2026-10-20 13:20:21 发布 1.6k 阅读 AI 写同款· GEO 优化 ›

springboot 3 下连接 mysql 数据库以及整合 mybatis-plus springboot 3版本整合 mybatis 3.0.5版本控制台报错 Property 'sqlSessionFactory' or 'sqlSessionTemplate' are required，NestedIOException 这个类在 Spring 6 版本中直接删除了。对的，直接删除了。而 MyBatis 老版本还没有同步更新，所以直接就报红了。而整合 mybatis 的 mybatis-plus 自然也会报红。阅读详情

Spring Boot + MyBatis-Plus 快速连接 MySQL

MyBatis-Plus（简称MP）是MyBatis的增强工具，在MyBatis基础上做了无侵入式扩展，核心优势是“简化开发、提高效率”——无需编写大量XML映射文件，无需手动写CRUD基础语句，就能快速实现MySQL数据库的连接与操作。

本文面向Spring Boot新手，全程贴合实战，从环境准备、项目搭建、配置编写、代码实现到测试验证，一步一步教你快速完成Spring Boot + MyBatis-Plus连接MySQL，同时梳理高频踩坑点，规避连接失败、查询无结果等问题，确保新手也能一次成功，快速上手数据库操作。

一、前置准备：环境与依赖确认（必看，避坑基础）

连接MySQL前，需确保本地环境和核心依赖匹配，避免因版本不兼容、环境未配置导致连接失败，以下是标准配置，新手直接照搬即可。

1. 本地环境要求

JDK：1.8 及以上（优先1.8，兼容性最佳，避开17+，减少依赖冲突）；
Spring Boot：2.7.x 稳定版（新手不推荐3.x，部分语法和依赖有差异，上手难度高）；
MyBatis-Plus：3.5.x 版本（与Spring Boot 2.7.x 完美适配，无兼容性问题）；
MySQL：5.7 或 8.0 版本（本文以MySQL 8.0 为例，5.7仅数据库驱动配置略有差异，文末补充说明）；
开发工具：IDEA 社区版（免费够用，内置Maven、Spring Boot模板，简化操作）；
构建工具：Maven 3.6.3（提前配置阿里云镜像，避免依赖下载超时）。

2. 核心依赖说明（无需手动写，IDEA自动导入）

Spring Boot集成MyBatis-Plus，无需手动引入MyBatis（MyBatis-Plus已内置），只需引入4个核心依赖，IDEA创建项目时勾选对应选项即可自动导入，也可手动在pom.xml中添加。

<!-- 1. Spring Boot 核心启动器（必选） -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

<!-- 2. MyBatis-Plus 启动器（核心，替代MyBatis） -->
<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-boot-starter</artifactId>
    <version>3.5.3.1&lt;/version&gt;  <!-- 与Spring Boot 2.7.x适配 -->
</dependency>

<!-- 3. MySQL 驱动（必选，区分5.7和8.0） -->
<dependency>
    <groupId>com.mysql</groupId>
    <artifactId>mysql-connector-j</artifactId>
    <scope>runtime</scope> <!-- MySQL 8.0 驱动（推荐） -->
</dependency>

<!-- 4.  lombok（可选，简化实体类编写，无需写get/set方法） -->
<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <optional>true</optional>
</dependency>

<!-- 5. 测试依赖（必选，用于测试数据库连接和CRUD） -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-test</artifactId>
    <scope>test</scope>
</dependency>

避坑提醒：MySQL 5.7 需替换驱动依赖为 mysql-connector-java（版本5.1.47），并修改驱动类名称，具体差异见文末补充。

二、快速搭建：Spring Boot 项目创建（IDEA实操）

新手直接跟着IDEA步骤操作，无需手动创建文件夹和配置文件，5分钟完成项目搭建。

步骤1：新建Spring Boot项目

打开IDEA → 点击「New Project」→ 左侧选中「Spring Initializr」→ 右侧默认「Default」（https://start.spring.io/）→ 点击「Next」。

步骤2：填写项目基础信息

Name：项目名称（如 spring-boot-mp-mysql，无需中文、空格）；
Group：包名（如 com.example，可自定义）；
Artifact：项目标识（默认与Name一致，无需修改）；
Java Version：选择 8（必须与本地JDK版本一致）；
Packaging：选择 Jar（默认，便于后续打包部署）；

填写完成后，点击「Next」。

步骤3：勾选核心依赖

左侧导航栏依次勾选以下依赖（IDEA自动搜索，勾选后自动导入pom.xml）：

Web → Spring Web（用于后续编写接口测试）；
SQL → MyBatis-Plus Boot Starter（核心依赖，必选）；
SQL → MySQL Driver（MySQL驱动，必选）；
Developer Tools → Lombok（可选，简化实体类）；

勾选完成后，点击「Next」。

步骤4：确认项目路径，完成创建

选择项目保存路径（关键：无中文、无空格，如 D:\spring-boot-project\spring-boot-mp-mysql）→ 点击「Finish」。

等待1-3分钟，IDEA自动加载项目、下载依赖（配置了阿里云镜像，速度更快），依赖下载完成后，项目结构无红色报错，即为搭建成功。

三、核心配置：编写 application.yml（连接MySQL关键）

项目搭建完成后，删除默认的 application.properties 文件，新建 application.yml 文件（Spring Boot优先识别yml格式），编写数据库连接配置和MyBatis-Plus基础配置，这是连接MySQL的核心步骤。

步骤1：新建 application.yml 文件

在 resources 目录下 → 右键 → New → File → 文件名填写 application.yml → 点击「OK」。

步骤2：编写配置内容（MySQL 8.0 示例）

复制以下配置，重点修改3处：数据库名称、数据库账号、数据库密码，其余配置无需修改，直接复用。

# 服务器配置（可选，可默认）
server:
  port: 8081  # 项目启动端口，避免与其他项目冲突
  servlet:
    context-path: /mp  # 上下文路径，可选

# 数据库连接配置（核心，必须修改）
spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver  # MySQL 8.0 驱动类（固定）
    url: jdbc:mysql://localhost:3306/mp_demo?useUnicode=true&characterEncoding=utf8&serverTimezone=GMT%2B8&useSSL=false
    # 说明：url中需修改 mp_demo 为你的本地数据库名称，3306为MySQL默认端口（未修改过则无需改）
    username: root  # 你的MySQL账号（默认root）
    password: 123456  # 你的MySQL密码（安装MySQL时设置的密码）

# MyBatis-Plus 配置（核心，简化开发）
mybatis-plus:
  mapper-locations: classpath:mapper/**/*.xml  #  mapper.xml文件存放路径（可选，后续自定义SQL时用）
  type-aliases-package: com.example.springbootmpmysql.entity  # 实体类包路径（必须修改为你的包名）
  configuration:
    map-underscore-to-camel-case: true  # 开启下划线转驼峰（如数据库字段 user_name → 实体类 userName）
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl  # 开启SQL日志打印（可选，便于调试，查看执行的SQL语句）

配置关键说明（避坑重点）

url 配置：
mp_demo：需替换为你本地已创建的MySQL数据库名称（提前手动创建，下文有步骤）；
serverTimezone=GMT%2B8：MySQL 8.0 必须添加时区配置（GMT%2B8代表东八区，避免时区错乱）；
useSSL=false：关闭SSL连接（本地开发无需开启，开启可能导致连接失败）；
& 转义：yml中直接写 & 会解析失败，需用 & 或用单引号包裹url（本文示例已处理，直接复用即可）。
driver-class-name：MySQL 8.0 固定为 com.mysql.cj.jdbc.Driver，MySQL 5.7 为 com.mysql.jdbc.Driver。
type-aliases-package：必须替换为你项目中「实体类」所在的包路径（后续创建实体类需放在该包下，否则MyBatis-Plus无法识别）。

四、前置操作：MySQL 数据库创建（手动操作）

需提前在本地MySQL中创建数据库（与yml配置中的数据库名称一致），无需创建表（后续用MyBatis-Plus自动生成，或手动创建简单表测试）。

步骤1：打开MySQL客户端（Navicat/MySQL Workbench）

用账号密码登录本地MySQL（账号root，密码为你安装MySQL时设置的密码）。

步骤2：创建数据库

执行以下SQL语句，创建数据库（名称与yml中url 里的 mp_demo 一致，编码格式为UTF-8）：

-- 创建数据库（名称mp_demo，可自定义，需与yml配置一致）
CREATE DATABASE IF NOT EXISTS mp_demo 
DEFAULT CHARACTER SET utf8mb4 
DEFAULT COLLATE utf8mb4_general_ci;

执行完成后，刷新数据库列表，即可看到创建好的 mp_demo 数据库。

步骤3：创建测试表（可选，用于后续测试）

为了验证数据库连接成功，手动创建一张简单的用户表（user），执行以下SQL：

-- 切换到mp_demo数据库
USE mp_demo;

-- 创建user表（简单测试用）
CREATE TABLE IF NOT EXISTS `user` (
  `id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '主键ID',
  `name` varchar(30) DEFAULT NULL COMMENT '姓名',
  `age` int(11) DEFAULT NULL COMMENT '年龄',
  `email` varchar(50) DEFAULT NULL COMMENT '邮箱',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='用户表';

五、代码实现：编写实体类、Mapper接口（极简）

MyBatis-Plus的核心优势的是“无需编写XML映射文件”，只需创建实体类和Mapper接口，就能自动实现CRUD操作，这里编写简单代码，用于测试数据库连接。

步骤1：创建实体类（Entity）

在 com.example.springbootmpmysql.entity 包下（包路径与yml中 type-aliases-package 一致），创建 User 实体类，对应MySQL中的 user 表。

package com.example.springbootmpmysql.entity;

import lombok.Data;
import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;

/**
 * 用户实体类，对应数据库user表
 */
@Data  // lombok注解，自动生成get/set、toString等方法
@TableName("user")  // 指定对应数据库表名（若实体类名与表名一致，可省略）
public class User {

    // 主键ID，自增（与数据库表中id字段对应）
    @TableId(type = IdType.AUTO)
    private Long id;

    // 姓名（与数据库表中name字段对应）
    private String name;

    // 年龄（与数据库表中age字段对应）
    private Integer age;

    // 邮箱（与数据库表中email字段对应）
    private String email;
}

说明：若未引入lombok，需手动编写get/set、toString方法，否则后续测试会报错。

步骤2：创建Mapper接口

在 com.example.springbootmpmysql.mapper 包下，创建 UserMapper 接口，继承 MyBatis-Plus 提供的 BaseMapper 接口（BaseMapper 已内置CRUD方法，无需手动编写）。

package com.example.springbootmpmysql.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.example.springbootmpmysql.entity.User;
import org.apache.ibatis.annotations.Mapper;

/**
 * UserMapper接口，继承BaseMapper，无需编写XML映射文件
 */
@Mapper  // 标记为MyBatis-Plus的Mapper接口，Spring Boot自动扫描
public interface UserMapper extends BaseMapper<User> {
    // 无需编写任何方法，BaseMapper已提供：selectById、selectList、insert、update、delete等方法
}

步骤3：启动类添加扫描注解（关键避坑）

打开项目启动类（如 SpringBootMpMysqlApplication.java），添加 @MapperScan 注解，指定Mapper接口所在的包路径，否则Spring Boot无法扫描到Mapper接口，会导致注入失败。

package com.example.springbootmpmysql;

import org.mybatis.spring.annotation.MapperScan;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
@MapperScan("com.example.springbootmpmysql.mapper")  // 扫描Mapper接口所在包（必须修改为你的包名）
public class SpringBootMpMysqlApplication {

    public static void main(String[] args) {
        SpringApplication.run(SpringBootMpMysqlApplication.class, args);
    }

}

避坑提醒：@MapperScan 注解中的包路径，必须与你创建的 Mapper 接口所在包一致，否则会报错「No qualifying bean of type ‘xxxMapper’ available」。

六、测试验证：确认数据库连接成功

编写测试代码，通过Spring Boot的测试类，测试数据库是否连接成功，以及MyBatis-Plus是否能正常操作数据库。

步骤1：创建测试类

在 test → java → com.example.springbootmpmysql 包下，找到默认的测试类（SpringBootMpMysqlApplicationTests.java），编写测试方法。

步骤2：编写测试代码

package com.example.springbootmpmysql;

import com.example.springbootmpmysql.entity.User;
import com.example.springbootmpmysql.mapper.UserMapper;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import java.util.List;

@SpringBootTest  // 标记为Spring Boot测试类，启动Spring容器
class SpringBootMpMysqlApplicationTests {

    // 自动注入UserMapper（Spring Boot扫描@Mapper注解后，自动创建实例）
    @Autowired
    private UserMapper userMapper;

    /**
     * 测试：查询所有用户（验证数据库连接和MyBatis-Plus配置）
     */
    @Test
    void testSelectList() {
        // BaseMapper内置方法：selectList(null) → 查询所有数据（null表示无查询条件）
        List<User> userList = userMapper.selectList(null);
        // 循环打印查询结果
        userList.forEach(user -> System.out.println("用户信息：" + user));
    }

    /**
     * 测试：新增用户（验证插入操作）
     */
    @Test
    void testInsert() {
        // 创建User对象，设置属性（id自增，无需设置）
        User user = new User();
        user.setName("张三");
        user.setAge(20);
        user.setEmail("zhangsan@163.com");
        // BaseMapper内置方法：insert → 新增数据
        int rows = userMapper.insert(user);
        System.out.println("新增成功，影响行数：" + rows);
        System.out.println("新增用户ID：" + user.getId());  // 新增后，自增ID会自动回显到user对象中
    }

}

步骤3：运行测试方法

右键点击 testInsert 方法 → 选择「Run ‘testInsert()’」，运行新增用户测试；
运行完成后，查看控制台：无红色报错，且打印「新增成功，影响行数：1」，说明数据库连接成功，新增操作正常；
再运行 testSelectList 方法，控制台会打印出新增的用户信息，说明查询操作正常。

测试成功标志

控制台无红色报错，SQL日志正常打印（开启了log-impl配置）；
新增用户后，打开MySQL客户端，查询user表，能看到新增的数据；
查询测试能正常打印出表中所有用户数据。

七、高频踩坑点汇总（新手必看）

整理了新手连接MySQL时最常遇到的5个问题，每个问题都附上根因和解决方案，遇到报错直接对照排查，快速解决。

踩坑1：数据库连接失败（Access denied for user ‘root’@‘localhost’）

✅ 报错原因：yml配置中 username 或 password 错误，与MySQL账号密码不匹配；

✅ 解决方案：核对MySQL账号密码，修改yml中的 username 和 password，确保与本地MySQL一致。

踩坑2：时区错误（ServerTimezone not set）

✅ 报错原因：MySQL 8.0 未在url中配置时区（serverTimezone=GMT%2B8）；

✅ 解决方案：在yml的url中添加 &serverTimezone=GMT%2B8，重启项目即可。

踩坑3：Mapper注入失败（No qualifying bean of type ‘xxxMapper’ available）

✅ 报错原因：启动类未添加 @MapperScan 注解，或注解中的包路径错误；

✅ 解决方案：在启动类添加 @MapperScan，指定Mapper接口所在的包路径（如 com.example.xxx.mapper）。

踩坑4：SQL语句不打印，无法调试

✅ 报错原因：未开启MyBatis-Plus的SQL日志打印配置；

✅ 解决方案：在yml的mybatis-plus.configuration中，添加 log-impl: org.apache.ibatis.logging.stdout.StdOutImpl。

踩坑5：实体类与数据库表映射失败（Table ‘mp_demo.user’ doesn’t exist）

✅ 报错原因：实体类未添加 @TableName 注解指定表名，或表名与实体类名不一致；

✅ 解决方案：在实体类上添加 @TableName("user")，指定数据库表名（与MySQL中的表名一致）。

八、补充说明：MySQL 5.7 与 8.0 配置差异

若本地MySQL是5.7版本，只需修改2处配置，其余步骤与8.0一致，具体差异如下：

1. 驱动依赖修改

<!-- MySQL 5.7 驱动依赖（替换8.0的驱动） -->
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>5.1.47</version>
    <scope>runtime</scope>
</dependency>

2. yml配置修改

spring:
  datasource:
    driver-class-name: com.mysql.jdbc.Driver  # 5.7 驱动类（去掉cj）
    url: jdbc:mysql://localhost:3306/mp_demo?useUnicode=true&characterEncoding=utf8&useSSL=false
    # 5.7 无需配置serverTimezone，其余配置与8.0一致
    username: root
    password: 123456