做后端开发的,谁还没跟数据库连接打过架?我记得刚学 Spring Boot 那会儿,照着教程敲完代码,启动时连报三个错,一下午全耗在 MySQL 连接上。后来把 MyBatis-Plus 用顺了,才发现这些坑大多能一次避开。这篇就围绕“Spring Boot + MyBatis-Plus 快速连接 MySQL”这个主题,把从项目初始化、依赖配置、数据源连接,到实体类、Mapper、CRUD 接口跑通这一整条链路掰开揉碎讲清楚,适合刚入门 Spring Boot 的 Java 开发者,也适合想把持久层换成 MyBatis-Plus 的老手。你不用照着命令行一步步死记,重要的是理解每个环节为什么这么配,后面遇到问题才知道去哪排查。
1. 项目整体设计与技术选型思路
1.1 为什么持久层框架选 MyBatis-Plus
Spring Boot 项目里操作 MySQL,主流无非三条路:Spring Data JPA、原生 MyBatis、MyBatis-Plus。JPA 对复杂 SQL 和动态 SQL 不够友好,实体关系复杂之后性能不好控制;原生 MyBatis 灵活但样板代码多,写一个简单的单表 CRUD 要配 Mapper XML、ResultMap,工作量不小。MyBatis-Plus 是 MyBatis 的增强工具,只做增强不做改变,单表 CRUD 直接继承 BaseMapper 就有现成方法,不用写 SQL,复杂查询又能退回到 XML 或注解自己写,可以说兼顾了效率和灵活度。
我实际用下来最舒服的一点是,MyBatis-Plus 内置了条件构造器 Wrapper,像“根据姓名模糊查询、年龄大于多少、按时间倒序”这种动态 SQL,在 Java 代码里链式写就行,既不会拼 SQL 拼到怀疑人生,也能避免字符串条件拼接带来的 SQL 注入风险。这套东西在国内团队里普及率很高,新同事上手快,代码风格也统一。
1.2 Spring Boot、MyBatis-Plus、MySQL 版本怎么配
版本选型是新手容易忽略、但踩坑最多的地方。Spring Boot 2.7.x 搭配 MyBatis-Plus 3.5.x 和 MySQL 8.0,是目前最稳的组合,网上资料多,遇到问题基本都能搜到答案。如果你用的是 Spring Boot 3.x,那就要注意了——从 3.0 开始,Spring 全面拥抱 Jakarta EE,MyBatis-Plus 也单独出了 mybatis-plus-spring-boot3-starter,直接依赖旧版会缺包。
还有个坑是 MySQL 驱动版本。MySQL 8.0 之后的官方驱动建议用 com.mysql:mysql-connector-j,类名是 com.mysql.cj.jdbc.Driver。如果项目还写着老旧的 com.mysql.jdbc.Driver,连 8.x 数据库会直接报错。JDK 版本方面,Spring Boot 2.7 可以用 JDK 8 或 11,Spring Boot 3.x 要求 JDK 17 起步,这个也要提前确认好,别项目搭完了发现本机 JDK 版本不对。
1.3 数据库准备:本地安装还是 Docker 跑一个
连接 MySQL 之前,得先有一个能连的 MySQL 实例。这里两条路:一是官网下载 MySQL 安装包本地装,这也是热词里很多人搜“mysql安装教程”“mysql windows安装教程”的原因。Windows 下安装 MySQL 8 其实不难,下载 zip 包解压后,以管理员身份打开命令提示符,进入 bin 目录执行初始化命令,再启动服务就行,唯一要留意的是初始化时生成的临时密码,第一次登录必须改掉。
二是用 Docker 跑,我个人在开发环境更推荐这种方式,一条命令搞定,不用污染本机环境:
bash复制docker run -d \
--name mysql8 \
-p 3306:3306 \
-e MYSQL_ROOT_PASSWORD=123456 \
-e MYSQL_DATABASE=demo \
mysql:8.0
端口映射、root 密码、初始数据库都通过环境变量指定了,省心得很。日常连接数据库推荐用 MySQL Workbench 或 Navicat,建库建表看数据都方便。数据库准备这块,核心目标就是拿到一个能用的 IP、端口、账号、密码和库名,后面数据源配置全指望这几个参数。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 工程搭建与核心配置
2.1 用 Spring Initializr 初始化项目
工程创建最快的方式是去 Spring Initializr 网站生成,也可以用 IDEA 内置的 Spring Initializr。这里有个小建议:坐标选 com.example 这种没问题,但包名别带中文和特殊符号,否则后面扫描会有一些奇怪问题。创建项目时先只勾选 Web 依赖,MyBatis-Plus 和 MySQL 驱动后面手工加,因为很多初始化器里根本没有 MyBatis-Plus 选项,它还不在 Spring 官方维护的依赖列表里。
用 IDEA 创建完项目之后,建议顺手把 maven-wrapper 相关文件检查一下,如果下载依赖很慢,就在 settings.xml 里配置阿里云镜像仓库。这一步看似跟连接数据库无关,但依赖拉不下来,后面所有代码都跑不起来,属于典型的“没出门先被门槛绊倒”。
2.2 依赖引入的先后与避坑
pom.xml 是整个工程的地基。Spring Boot 项目一定有父工程 spring-boot-starter-parent,版本号用 2.7.18 这类稳定版就行,不用刻意追新。核心依赖三个:spring-boot-starter-web 提供 Web 能力,mybatis-plus-boot-starter 引入 MyBatis-Plus,mysql-connector-j 是数据库驱动。
xml复制<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.7.18</version>
<relativePath/>
</parent>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-p
