MyBatis到底难不难？零基础也能轻松上手的Java持久层入门指南

延迟优化师

2025-12-25 20:49

阅读 752

大家好，我是小林，一名211高校的计算机专业研究生。平时除了写论文、做项目，我最喜欢的事情就是在技术博客上分享学习心得。最近有几位学弟学妹私信问我：“学Java后端，MyBatis是不是很难？”、“面试官总问MyBatis原理，但我连怎么用都搞不清”……这让我想起了自己当初刚接触MyBatis时的迷茫——配置文件看不懂、SQL写不对、报错信息像天书。

其实，MyBatis并没有想象中那么可怕。今天我就以“问题解决思路”为主线，手把手带你从零搭建一个完整的MyBatis应用。无论你是准备求职的应届生，还是想转行做后端开发的运营同学（没错，我认识一位从运营成功转型的程序员！），只要会写最基础的Java，就能跟上这篇教程。

一、MyBatis是干啥的？为什么不用直接写JDBC？

简单说：MyBatis 是一个帮你把 Java 对象和数据库记录自动“翻译”的工具。

想象一下，你有一张用户表 user(id, name, email)，现在想把数据库里的数据变成 Java 对象 User。如果用原始 JDBC，你需要：

写 SQL 语句
手动建立数据库连接
执行查询
遍历 ResultSet
把每一列的值 getString("name") 赋给 Java 对象

代码又长又容易出错。而 MyBatis 帮你自动完成了第4、5步——你只需要告诉它“SQL 怎么写”和“结果映射到哪个类”，剩下的交给框架。

💡 小贴士：虽然现在有 Spring Data JPA、Hibernate 等更“自动化”的框架，但 MyBatis 因其灵活控制 SQL 的特性，在国内企业（尤其是互联网公司）中使用非常广泛。掌握 MyBatis，对求职大有帮助！

二、环境准备：5分钟搭好开发环境

我们不需要复杂的 IDE 插件，只需以下工具：

工具	版本建议	说明
JDK	8 或 11	Java 开发基础
Maven	3.6+	依赖管理（也可用 Gradle，本文用 Maven）
MySQL	5.7+	数据库（其他如 PostgreSQL 也支持）
IDEA / VS Code	最新版	推荐 IDEA，对 Java 支持更好

步骤 1：创建 Maven 项目

打开终端，执行：

mvn archetype:generate -DgroupId=com.example -DartifactId=mybatis-demo -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false

步骤 2：添加 MyBatis 和 MySQL 依赖

编辑 pom.xml，加入以下内容：

<dependencies>
    <!-- MyBatis 核心 -->
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.5.13</version>
    </dependency>
    
    <!-- MySQL 驱动 -->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>8.0.33</version>
    </dependency>
    
    <!-- 单元测试（可选） -->
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.13.2</version>
        <scope>test</scope>
    </dependency>
</dependencies>

⚠️ 注意：如果你用的是 MySQL 8.0+，驱动类名是 com.mysql.cj.jdbc.Driver，别写成老版本的 com.mysql.jdbc.Driver！

三、核心概念：Mapper、SQL 映射、配置文件

MyBatis 有三个关键角色：

SqlSessionFactory：工厂，用来创建数据库会话（SqlSession）
Mapper 接口：你定义的 Java 接口，方法对应 SQL 操作
XML 映射文件：写 SQL 的地方，告诉 MyBatis 如何执行和映射结果

我当初踩过的坑

第一次写 MyBatis 时，我把 Mapper 接口的方法名和 XML 中的 id 写得不一样，结果一直报 BindingException。记住：接口方法名必须和 XML 中 <select id="xxx"> 的 id 完全一致！

四、实战：从零实现一个用户查询功能

我们将完成一个最简单的功能：根据 ID 查询用户信息。

步骤 1：创建数据库和表

CREATE DATABASE mybatis_demo;
USE mybatis_demo;

CREATE TABLE user (
    id INT PRIMARY KEY AUTO_INCREMENT,
    name VARCHAR(50),
    email VARCHAR(100)
);

INSERT INTO user (name, email) VALUES 
('张三', 'zhangsan@example.com'),
('李四', 'lisi@example.com');

步骤 2：编写 MyBatis 配置文件 `mybatis-config.xml`

在 src/main/resources 下创建该文件：

<?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="development">
    <environment id="development">
      <transactionManager type="JDBC"/>
      <dataSource type="POOLED">
        <property name="driver" value="com.mysql.cj.jdbc.Driver"/>
        <property name="url" value="jdbc:mysql://localhost:3306/mybatis_demo?useSSL=false&amp;serverTimezone=UTC"/>
        <property name="username" value="root"/>
        <property name="password" value="你的密码"/>
      </dataSource>
    </environment>
  </environments>
  
  <!-- 注册 Mapper XML 文件 -->
  <mappers>
    <mapper resource="UserMapper.xml"/>
  </mappers>
</configuration>

步骤 3：创建 User 实体类

// src/main/java/com/example/User.java
package com.example;

public class User {
    private int id;
    private String name;
    private String email;
    
    // 必须有无参构造函数（MyBatis 反射需要）
    public User() {}
    
    // getter 和 setter
    public int getId() { return id; }
    public void setId(int 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; }
    
    @Override
    public String toString() {
        return "User{id=" + id + ", name='" + name + "', email='" + email + "'}";
    }
}

步骤 4：创建 Mapper 接口

// src/main/java/com/example/UserMapper.java
package com.example;

public interface UserMapper {
    User selectUserById(int id);
}

步骤 5：编写 UserMapper.xml

<!-- src/main/resources/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.UserMapper">
  
  <select id="selectUserById" resultType="com.example.User" parameterType="int">
    SELECT id, name, email FROM user WHERE id = #{id}
  </select>
  
</mapper>

关键点解释：

namespace 必须是 Mapper 接口的全限定名
id 必须和接口方法名一致
resultType 指定返回对象的类路径
#{id} 是参数占位符，MyBatis 会自动替换为实际值

步骤 6：编写测试代码

// src/test/java/com/example/AppTest.java
package com.example;

import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import java.io.InputStream;

public class AppTest {
    public static void main(String[] args) throws Exception {
        // 1. 读取配置文件
        String resource = "mybatis-config.xml";
        InputStream inputStream = Resources.getResourceAsStream(resource);
        
        // 2. 创建 SqlSessionFactory
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        
        // 3. 获取 SqlSession
        try (SqlSession session = sqlSessionFactory.openSession()) {
            // 4. 获取 Mapper 接口代理对象
            UserMapper mapper = session.getMapper(UserMapper.class);
            
            // 5. 调用方法
            User user = mapper.selectUserById(1);
            System.out.println(user);
        }
    }
}

运行结果：

User{id=1, name='张三', email='zhangsan@example.com'}

✅ 恭喜！你已经成功运行了第一个 MyBatis 程序！

五、新手常见问题解答（FAQ）

Q1：为什么报 `ClassNotFoundException: com.mysql.cj.jdbc.Driver`？

A：检查 pom.xml 是否引入了 MySQL 驱动，并确认版本是否匹配你的 MySQL 服务器版本。

Q2：`There is no getter for property named 'xxx'` 是什么意思？

A：MyBatis 默认通过 getter/setter 访问属性。确保你的实体类有对应的 getXxx() 方法，且命名符合 JavaBean 规范（首字母小写）。

Q3：能不用 XML 吗？我想用注解！

A：可以！MyBatis 支持注解方式。例如：

public interface UserMapper {
    @Select("SELECT * FROM user WHERE id = #{id}")
    User selectUserById(int id);
}

但复杂 SQL（如多表联查）仍推荐用 XML，更清晰易维护。

Q4：和 Go 语言有什么关系？

A：虽然本文讲的是 Java 的 MyBatis，但如果你熟悉 Go，可以类比 Go 的 GORM 或 sqlx 库——它们也是 ORM/SQL 映射工具。不同语言生态有相似的设计思想，掌握一种后，理解其他会更快。这也是我常在技术分享中强调的“底层逻辑迁移能力”。

六、学习建议与下一步

给求职者的建议

MyBatis 是 Java 后端岗的高频考点，务必掌握基本用法、缓存机制、动态 SQL。
在简历项目中，可以写“使用 MyBatis 实现数据持久化，优化 SQL 查询性能”等描述。
面试常问：#{} 和 ${} 的区别？一级缓存和二级缓存？如何防止 SQL 注入？

给转行者的鼓励

我认识一位前运营同事，她利用业余时间系统学习 Java 和 MyBatis，半年后成功入职一家电商公司做后端开发。她的秘诀就是：每天写一点代码，坚持做小项目。你也可以！

下一步学什么？

整合 Spring Boot：实际项目几乎都用 Spring Boot + MyBatis
学习动态 SQL：<if>, <foreach> 等标签处理复杂查询
了解分页插件：如 PageHelper
探索 MyBatis-Plus：国产增强工具，简化 CRUD

结语

MyBatis 的核心思想其实很简单：解耦 SQL 与业务代码，让开发者专注逻辑而非重复劳动。作为过来人，我想说：不要被“框架”两个字吓到。从今天这个小例子开始，一步步构建自己的知识体系。

如果你觉得这篇教程对你有帮助，欢迎点赞、收藏，也欢迎在评论区留言交流。我会持续更新更多面向新人的技术分享，帮助你在编程路上少走弯路。毕竟，我也曾是那个对着报错信息抓耳挠腮的新手啊！

技术之路，贵在坚持。你离成为一名合格的后端工程师，只差一个 main 方法的距离。

标签:Go运营技术分享求职

最热最新

暂无评论

为你推荐

暂无相关推荐

MyBatis到底难不难？零基础也能轻松上手的Java持久层入门指南

一、MyBatis是干啥的？为什么不用直接写JDBC？

二、环境准备：5分钟搭好开发环境

步骤 1：创建 Maven 项目

步骤 2：添加 MyBatis 和 MySQL 依赖

三、核心概念：Mapper、SQL 映射、配置文件

我当初踩过的坑

四、实战：从零实现一个用户查询功能

步骤 1：创建数据库和表

步骤 2：编写 MyBatis 配置文件 `mybatis-config.xml`

步骤 3：创建 User 实体类

步骤 4：创建 Mapper 接口

步骤 5：编写 UserMapper.xml

步骤 6：编写测试代码

五、新手常见问题解答（FAQ）

Q1：为什么报 `ClassNotFoundException: com.mysql.cj.jdbc.Driver`？

Q2：`There is no getter for property named 'xxx'` 是什么意思？

Q3：能不用 XML 吗？我想用注解！

Q4：和 Go 语言有什么关系？

六、学习建议与下一步

给求职者的建议

给转行者的鼓励

下一步学什么？

结语

评论 0

为你推荐

精选内容

MyBatis到底难不难？零基础也能轻松上手的Java持久层入门指南

一、MyBatis是干啥的？为什么不用直接写JDBC？

二、环境准备：5分钟搭好开发环境

步骤 1：创建 Maven 项目

步骤 2：添加 MyBatis 和 MySQL 依赖

三、核心概念：Mapper、SQL 映射、配置文件

我当初踩过的坑

四、实战：从零实现一个用户查询功能

步骤 1：创建数据库和表

步骤 2：编写 MyBatis 配置文件 mybatis-config.xml

步骤 3：创建 User 实体类

步骤 4：创建 Mapper 接口

步骤 5：编写 UserMapper.xml

步骤 6：编写测试代码

五、新手常见问题解答（FAQ）

Q1：为什么报 ClassNotFoundException: com.mysql.cj.jdbc.Driver？

Q2：There is no getter for property named 'xxx' 是什么意思？

Q3：能不用 XML 吗？我想用注解！

Q4：和 Go 语言有什么关系？

六、学习建议与下一步

给求职者的建议

给转行者的鼓励

下一步学什么？

结语

评论 0

为你推荐

相关推荐

精选内容

步骤 2：编写 MyBatis 配置文件 `mybatis-config.xml`

Q1：为什么报 `ClassNotFoundException: com.mysql.cj.jdbc.Driver`？

Q2：`There is no getter for property named 'xxx'` 是什么意思？