AI 助理
备案控制台
开发者社区 数据库 文章 正文

吃透 MyBatis 核心

2025-12-30 5
版权
版权声明：
本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写 侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
简介： 本文系统解析MyBatis核心原理与实战应用，涵盖架构流程、动态SQL、关联查询、缓存机制及PageHelper分页插件，结合Druid数据源优化与阿里云部署实践，助力开发者掌握Java持久层核心技术，提升数据库操作效率与项目部署能力。

一文吃透 MyBatis 核心：从原理到实战，附阿里云部署最佳实践
MyBatis 是一款优秀的半自动 ORM（对象关系映射）框架，也是 Java 后端开发中最主流的数据库访问框架之一。它摒弃了 JDBC 的硬编码弊端，通过 XML / 注解灵活配置 SQL，兼具原生 SQL 的灵活性与 ORM 的便捷性。本文将从核心原理、实战用法、高级特性到阿里云部署全维度解析 MyBatis，帮助开发者彻底掌握这一核心技术。
一、MyBatis 核心架构与工作原理

  1. 核心定位：为什么选择 MyBatis？
    对比 JDBC 和 Hibernate，MyBatis 的核心优势：
    特性 JDBC Hibernate MyBatis
    SQL 控制 硬编码，灵活性高 自动生成，灵活性低 手动配置，灵活可控
    开发效率 低（需手写所有代码） 高（全自动 ORM） 中高（半自动化）
    性能 高（原生） 中（自动 SQL 优化差） 高（可手动优化 SQL）
    学习成本 低 高（需掌握 HQL） 中（SQL 基础即可）
  2. MyBatis 核心工作流程
    plaintext
  3. 加载MyBatis配置文件（mybatis-config.xml）→ 2. 创建SqlSessionFactory（会话工厂）→
  4. 通过工厂创建SqlSession（会话）→ 4. 执行Mapper中的SQL → 5. 封装结果为Java对象 → 6. 关闭SqlSession
  5. 核心组件解析
    组件 作用
    SqlSessionFactory 全局唯一的工厂类，负责创建 SqlSession，基于单例模式管理
    SqlSession 数据库会话，封装 CRUD 操作，非线程安全，需每次使用后关闭
    Mapper接口/XML 定义 SQL 映射规则，接口方法与 XML 中的 SQL 一一对应
    Executor MyBatis 核心执行器，负责 SQL 执行与结果集处理（默认 SimpleExecutor）
    StatementHandler 处理 JDBC 的 Statement 对象，封装 SQL 执行细节
    ResultHandler 处理 SQL 执行结果，将结果集映射为 Java 对象
    二、MyBatis 快速上手（实战）
  6. 环境准备（Maven 依赖）
    xml
    org.mybatis
    mybatis
    3.5.13



    mysql
    mysql-connector-java
    8.0.33



    log4j
    log4j
    1.2.17
  7. 核心配置文件（mybatis-config.xml）
    放置在src/main/resources目录下，配置环境、数据源、映射器等核心信息：
    xml
    <?xml version="1.0" encoding="UTF-8" ?>
    <!DOCTYPE configuration
     PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
 "http://mybatis.org/dtd/mybatis-3-config.dtd">



















  8. 实体类（POJO）
    java
    运行
    package com.example.pojo;

// 数据库user表对应的实体类
public class User {
private Integer id;
private String username;
private String password;
private Integer age;
private String email;

// 无参构造、全参构造
public User() {}
public User(Integer id, String username, String password, Integer age, String email) {
    this.id = id;
    this.username = username;
    this.password = password;
    this.age = age;
    this.email = email;
}

// Getter/Setter
public Integer getId() { return id; }
public void setId(Integer id) { this.id = id; }
public String getUsername() { return username; }
public void setUsername(String username) { this.username = username; }
public String getPassword() { return password; }
public void setPassword(String password) { this.password = password; }
public Integer getAge() { return age; }
public void setAge(Integer age) { this.age = age; }
public String getEmail() { return email; }
public void setEmail(String email) { this.email = email; }

// toString
@Override
public String toString() {
    return "User{" +
            "id=" + id +
            ", username='" + username + '\'' +
            ", password='" + password + '\'' +
            ", age=" + age +
            ", email='" + email + '\'' +
            '}';
}

}

  1. Mapper 接口（数据访问层）
    java
    运行
    package com.example.mapper;

import com.example.pojo.User;
import org.apache.ibatis.annotations.Param;

import java.util.List;

// UserMapper接口（与XML映射）
public interface UserMapper {
// 根据ID查询用户
User getUserById(@Param("id") Integer id);

// 查询所有用户
List<User> getAllUsers();

// 添加用户
int addUser(User user);

// 修改用户
int updateUser(User user);

// 删除用户
int deleteUser(@Param("id") Integer id);

}

  1. Mapper.xml 映射文件
    放置在src/main/resources/com/example/mapper目录下，配置 SQL 与接口方法的映射：
    xml
    <?xml version="1.0" encoding="UTF-8" ?>
    <!DOCTYPE mapper

     PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
 "http://mybatis.org/dtd/mybatis-3-mapper.dtd">












    SELECT FROM user WHERE id = #{id}




    SELECT     FROM user




    INSERT INTO user(username, password, age, email)
    VALUES (#{username}, #{password}, #{age}, #{email})




    UPDATE user
    SET username = #{username}, password = #{password}, age = #{age}, email = #{email}
    WHERE id = #{id}




    DELETE FROM user WHERE id = #{id}

  2. 测试类（核心 API 使用）
    java
    运行
    package com.example.test;

import com.example.mapper.UserMapper;
import com.example.pojo.User;
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.IOException;
import java.io.InputStream;
import java.util.List;

public class MyBatisTest {
public static void main(String[] args) throws IOException {
// 1. 加载MyBatis配置文件
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);

    // 2. 创建SqlSessionFactory
    SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

    // 3. 创建SqlSession（true：自动提交事务）
    try (SqlSession session = sqlSessionFactory.openSession(true)) {
        // 4. 获取Mapper代理对象
        UserMapper userMapper = session.getMapper(UserMapper.class);

        // 测试查询单个用户
        User user = userMapper.getUserById(1);
        System.out.println("查询单个用户：" + user);

        // 测试查询所有用户
        List<User> userList = userMapper.getAllUsers();
        System.out.println("查询所有用户：");
        userList.forEach(System.out::println);

        // 测试添加用户
        User newUser = new User(null, "mybatis_test", "123456", 25, "test@mybatis.com");
        int addResult = userMapper.addUser(newUser);
        System.out.println("添加用户结果：" + (addResult > 0 ? "成功" : "失败"));

        // 测试修改用户
        User updateUser = new User(5, "mybatis_update", "654321", 26, "update@mybatis.com");
        int updateResult = userMapper.updateUser(updateUser);
        System.out.println("修改用户结果：" + (updateResult > 0 ? "成功" : "失败"));

        // 测试删除用户
        int deleteResult = userMapper.deleteUser(5);
        System.out.println("删除用户结果：" + (deleteResult > 0 ? "成功" : "失败"));
    }
}

}
三、MyBatis 核心高级特性

  1. 动态 SQL（MyBatis 的核心亮点）
    通过、、等标签实现 SQL 动态拼接，解决多条件查询痛点：
    xml
    SELECT * FROM user


    AND username LIKE CONCAT('%', #{username}, '%')


    AND age = #{age}


    AND email LIKE CONCAT('%', #{email}, '%')



DELETE FROM user WHERE id IN

    #{id}
</foreach>

  1. 关联查询（一对一 / 一对多）
    （1）一对一（如用户 - 订单）
    xml









    （2）一对多（如用户 - 多个订单）
    xml










  2. 缓存机制
    MyBatis 提供两级缓存，提升查询性能：
    一级缓存：SqlSession 级别（默认开启），同一会话内重复查询相同 SQL 会缓存结果；
    二级缓存：Mapper 级别，需手动开启（在 Mapper.xml 中添加），不同 SqlSession 共享缓存。
  3. 分页插件（PageHelper）
    简化分页开发，是 MyBatis 最常用的插件：
    xml
    com.github.pagehelper
    pagehelper
    5.3.2

    java
    运行
    // 分页查询示例
    PageHelper.startPage(1, 5); // 第1页，每页5条
    List userList = userMapper.getAllUsers();
    PageInfo pageInfo = new PageInfo<>(userList);
    System.out.println("总条数：" + pageInfo.getTotal());
    System.out.println("总页数：" + pageInfo.getPages());
    四、MyBatis 项目部署到阿里云
  4. 阿里云环境准备
    （1）安装 MySQL 并创建数据库
    bash
    运行

    登录阿里云ECS（CentOS 7）

    ssh root@服务器公网IP

安装MySQL

yum install -y mariadb-server
systemctl start mariadb
systemctl enable mariadb
mysql_secure_installation # 初始化密码

登录MySQL，创建数据库和表

mysql -uroot -p
CREATE DATABASE IF NOT EXISTS mybatis_db DEFAULT CHARACTER SET utf8mb4;
USE mybatis_db;

创建user表

CREATE TABLE user (
id INT PRIMARY KEY AUTO_INCREMENT,
username VARCHAR(50) NOT NULL,
password VARCHAR(50) NOT NULL,
age INT,
email VARCHAR(100)
);
（2）修改 MyBatis 配置文件（适配阿里云）
将mybatis-config.xml中的数据库地址改为阿里云服务器 IP：
xml

  1. 项目打包与上传
    bash
    运行

    本地打包（JAR包）

    mvn clean package -DskipTests

上传JAR包到阿里云

scp target/mybatis-demo-1.0-SNAPSHOT.jar root@服务器公网IP:/usr/local/mybatis/

  1. 运行项目
    bash
    运行

    进入目录

    cd /usr/local/mybatis/

运行JAR包

nohup java -jar mybatis-demo-1.0-SNAPSHOT.jar > app.log 2>&1 &

查看日志

tail -f app.log

  1. 生产环境优化
    （1）配置数据源连接池（Druid）
    替换 MyBatis 默认数据源为 Druid，提升连接复用率：
    xml
    com.alibaba
    druid
    1.2.16











（2）开启 MyBatis 日志（生产环境）
配置log4j.properties，记录 SQL 执行日志便于排查问题：
properties
log4j.rootLogger=INFO, Console, File

控制台输出

log4j.appender.Console=org.apache.log4j.ConsoleAppender
log4j.appender.Console.layout=org.apache.log4j.PatternLayout
log4j.appender.Console.layout.ConversionPattern=%d [%t] %-5p [%c] - %m%n

文件输出

log4j.appender.File=org.apache.log4j.RollingFileAppender
log4j.appender.File.File=/usr/local/mybatis/logs/mybatis.log
log4j.appender.File.MaxFileSize=10MB
log4j.appender.File.MaxBackupIndex=10
log4j.appender.File.layout=org.apache.log4j.PatternLayout
log4j.appender.File.layout.ConversionPattern=%d [%t] %-5p [%c] - %m%n

MyBatis日志级别（DEBUG可打印SQL）

log4j.logger.org.mybatis=DEBUG
log4j.logger.com.example.mapper=DEBUG
五、MyBatis 高频面试题与避坑指南

  1. 核心面试题
    MyBatis 中#{}和${}的区别？

    {}：预编译，防 SQL 注入，参数会被加引号；

    ${}：字符串拼接，有 SQL 注入风险，参数直接替换（适用于表名 / 列名动态拼接）。
    MyBatis 的一级缓存和二级缓存的区别？
    一级缓存：SqlSession 级别，默认开启，关闭会话失效；
    二级缓存：Mapper 级别，需手动开启，不同会话共享，实体类需实现序列化。
    动态 SQL 有哪些标签？分别有什么作用？
    ：条件判断；：自动处理 AND/OR；：循环拼接；：更新时自动处理逗号；：多条件分支。
    MyBatis 如何解决字段名与实体类属性名不一致的问题？
    方案 1：SQL 中使用别名（SELECT user_name AS username FROM user）；
    方案 2：配置映射字段与属性。
  2. 避坑指南
    不要在SqlSession中存储共享数据（非线程安全）；
    动态 SQL 中标签可自动去除多余的 AND/OR，避免手动拼接出错；
    批量操作优先使用，而非循环调用单条 SQL（提升性能）；
    生产环境关闭二级缓存（避免数据一致性问题），优先使用 Redis 做分布式缓存。
    六、总结
    MyBatis 的核心价值在于「平衡灵活性与开发效率」—— 既保留了原生 SQL 的优化空间，又解决了 JDBC 的硬编码问题。掌握核心配置、动态 SQL、关联查询三大核心，结合 PageHelper、Druid 等插件，可满足绝大部分企业级开发需求。
    本文从原理到实战，再到阿里云部署，覆盖了 MyBatis 开发全流程。建议初学者从基础 CRUD 入手，逐步掌握动态 SQL 和高级特性，同时关注 MyBatis-Plus（MyBatis 增强工具）的学习，进一步提升开发效率。
    扩展学习资源
    官方文档：MyBatis 官方指南；
    实战书籍：《MyBatis 从入门到精通》《深入浅出 MyBatis 技术原理与实战》；
    插件文档：PageHelper 官方文档、Druid 连接池文档。
文章标签：
Java
SQL
mybatis
数据库连接
XML
aliyun3136691611-44619
目录
相关文章
阿里云安全_
|
5天前
第五届伏魔挑战赛如约来袭，诚邀各路高手来战！
伏魔再启，等你来战！
阿里云安全_
1179 3
第五届伏魔挑战赛如约来袭，诚邀各路高手来战！
阿里云安全_
|
13天前
|
数据采集 人工智能 安全
阿里云Web应用防火墙市场份额和技术能力双第一
喜报～～
阿里云安全_
1233 11
bailiantest1
|
8天前
|
编解码 人工智能 自然语言处理
⚽阿里云百炼通义万相 2.6 视频生成玩法手册
通义万相Wan 2.6是全球首个支持角色扮演的AI视频生成模型，可基于参考视频形象与音色生成多角色合拍、多镜头叙事的15秒长视频，实现声画同步、智能分镜，适用于影视创作、营销展示等场景。
bailiantest1
652 4
AI未闻花名
|
8天前
|
机器学习/深度学习 人工智能 前端开发
构建AI智能体：七十、小树成林，聚沙成塔：随机森林与大模型的协同进化
随机森林是一种基于决策树的集成学习算法，通过构建多棵决策树并结合它们的预测结果来提高准确性和稳定性。其核心思想包括两个随机性：Bootstrap采样（每棵树使用不同的训练子集）和特征随机选择（每棵树分裂时只考虑部分特征）。这种方法能有效处理大规模高维数据，避免过拟合，并评估特征重要性。随机森林的超参数如树的数量、最大深度等可通过网格搜索优化。该算法兼具强大预测能力和工程化优势，是机器学习中的常用基础模型。
AI未闻花名
350 164
1346981540777417
|
7天前
|
机器学习/深度学习 自然语言处理 机器人
阿里云百炼大模型赋能｜打造企业级电话智能体与智能呼叫中心完整方案
畅信达基于阿里云百炼大模型推出MVB2000V5智能呼叫中心方案，融合LLM与MRCP+WebSocket技术，实现语音识别率超95%、低延迟交互。通过电话智能体与座席助手协同，自动化处理80%咨询，降本增效显著，适配金融、电商、医疗等多行业场景。
1346981540777417
359 155

热门文章

最新文章

  • 1
    《自己动手写Docker》书摘之三： Linux UnionFS
  • 2
    全球首个成人搜索引擎Boodigo比谷歌还厉害
  • 3
    【深度】生态红利即将爆发，剖析阿里云市场软件交易与交付新战略
  • 4
    EDAS——如何快速定位OOM问题
  • 5
    TFS分布式文件系统应用
  • 6
    阿里云logo设计入口(在线一键生成)
  • 7
    【AI大模型应用开发】【综合实战】AI+搜索，手把手带你实现属于你的AI搜索引擎（附完整代码）
  • 8
    aswing学习笔记4-通过调用面板中的按钮实现主界面动态切换皮肤的问题！
  • 9
    Active Directory 回收站配置篇
  • 10
    C#学习笔记——接口
  • 1
    基于 YOLOv8 的驾驶员疲劳状态识别系统实战（含完整源码与可视化界面）
    55
  • 2
    基于 YOLOv8 的交通标识与设施识别系统（含完整源码）
    60
  • 3
    阿里云免费云服务器领取教程及阿里云免费云产品全解析：从资源配置到实用指南
    64
  • 4
    金融量化场景下阿里云服务器 ECS 实例规格族选择指南
    54
  • 5
    阿里云万小智 AI 建站系统全解析：版本功能、价格体系与场景适配
    67
  • 6
    别再当冤大头！知识管理工具避坑指南，选择真·提效神器
    46
  • 7
    阿里云 CDN 计费体系全解析：基础服务、增值服务与选型指南
    66
  • 8
    向量搜索升级指南：FAISS 到 Qdrant 迁移方案与代码实现
    34
  • 9
    租用阿里云服务器一年要多少钱？今年新手必看最新阿里云服务器价格表
    45
  • 10
    阿里云 DNS 云解析全解析：免费版与付费版差异对比及选型指南
    54

    • 相关电子书

    更多
  • 低代码开发师（初级）实战教程
  • 冬季实战营第三期：MySQL数据库进阶实战
  • 阿里巴巴DevOps 最佳实践手册
    • 下一篇
    基于Python+Vue开发的口腔牙科预约管理系统