MyBatis 环境配置完整教程（从 0 到 1）

一、什么是 MyBatis？

MyBatis是一个优秀的持久层（ORM）框架，它将 Java 对象与数据库表进行映射，通过XML 或注解的方式编写 SQL。

MyBatis 的特点

• 半自动 ORM（SQL 由程序员自己写）

• 支持动态 SQL

• 避免 JDBC 硬编码、减少样板代码

• 易学、可控性强

如果你学过 JDBC，可以把 MyBatis 理解为：
JDBC + 连接池 + SQL 映射 + 配置解耦

二、准备环境

1. 开发工具

• JDK 8+

• IntelliJ IDEA

• Maven 3.6+

• MySQL 5.7 / 8.0

三、创建 Maven 项目

1. 新建 Maven 工程

mybatis-demo

2.pom.xml引入依赖

<dependencies> <!-- MyBatis 核心 --> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis</artifactId> <version>3.5.16</version> </dependency> <!-- MySQL 驱动 --> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-j</artifactId> <version>8.0.33</version> </dependency> <!-- 日志 --> <dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-simple</artifactId> <version>2.0.12</version> </dependency> </dependencies>

四、创建数据库与表

CREATE DATABASE mybatis_db; USE mybatis_db; CREATE TABLE user ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50), password VARCHAR(50) );

五、项目目录结构（重点）

src └─ main ├─ java │ └─ com.example.mybatis │ ├─ entity │ │ └─ User.java │ ├─ mapper │ │ └─ UserMapper.java │ └─ test │ └─ MyBatisTest.java └─ resources ├─ mapper │ └─ UserMapper.xml └─ mybatis-config.xml

六、MyBatis 核心配置文件

1.mybatis-config.xml

<?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "https://mybatis.org/dtd/mybatis-3-config.dtd"> <configuration> <!-- 环境配置 --> <environments default="dev"> <environment id="dev"> <transactionManager type="JDBC"/> <dataSource type="POOLED"> <property name="driver" value="com.mysql.cj.jdbc.Driver"/> <property name="url" value="jdbc:mysql://localhost:3306/mybatis_db?useSSL=false&serverTimezone=UTC"/> <property name="username" value="root"/> <property name="password" value="123456"/> </dataSource> </environment> </environments> <!-- Mapper 映射 --> <mappers> <mapper resource="mapper/UserMapper.xml"/> </mappers> </configuration>

说明

• POOLED：MyBatis 内置连接池

• transactionManager：使用 JDBC 事务

• mappers：注册 SQL 映射文件

七、实体类（Entity）

User.java

package com.example.mybatis.entity; public class User { private Integer id; private String username; private String password; // getter / setter }

八、Mapper 接口

UserMapper.java

package com.example.mybatis.mapper; import com.example.mybatis.entity.User; public interface UserMapper { User selectById(int id); }

九、Mapper XML 映射文件

UserMapper.xml

<?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "https://mybatis.org/dtd/mybatis-3-mapper.dtd"> <mapper namespace="com.example.mybatis.mapper.UserMapper"> <select id="selectById" parameterType="int" resultType="com.example.mybatis.entity.User"> SELECT * FROM user WHERE id = #{id} </select> </mapper>

核心规则

• namespace必须是Mapper 接口全路径

• id对应接口方法名

• #{}是预编译参数

十、MyBatis 测试类

MyBatisTest.java

package com.example.mybatis.test; import com.example.mybatis.entity.User; import com.example.mybatis.mapper.UserMapper; import org.apache.ibatis.io.Resources; import org.apache.ibatis.session.*; import java.io.InputStream; public class MyBatisTest { public static void main(String[] args) throws Exception { // 1. 读取配置文件 InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml"); // 2. 构建 SqlSessionFactory SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(inputStream); // 3. 获取 SqlSession SqlSession sqlSession = factory.openSession(); // 4. 获取 Mapper UserMapper mapper = sqlSession.getMapper(UserMapper.class); // 5. 执行 SQL User user = mapper.selectById(1); System.out.println(user.getUsername()); // 6. 关闭资源 sqlSession.close(); } }

十一、常见错误与解决方案

Mapper 找不到

Invalid bound statement

✔ 检查：

• namespace 是否正确

• XML 是否注册到mybatis-config.xml

数据库连接失败

✔ 检查：

• 驱动版本

• URL 时区配置

• 用户名密码