SpringBootMyBatis操作数据库的实战指南

摘要

这篇文章要聊的，是Spring Boot环境下如何把MyBatis这个持久层框架用得顺手、用得明白。从传统JDBC的痛点讲起，一步步拆解MyBatis在日志配置、CRUD操作、自增主键返回以及多表查询中的实际玩法。当然，绕不开的是#{} 和${}这对“双胞胎”在底层预编译机制上的本质差异——这可是面试的高频考点。最后，还会结合企业级开发的惯例，说说数据库命名规范和Druid连接池的那些配置“潜规则”。希望能帮你搭建一个既稳当又高效的持久层。

1. 为什么持久层开发需要 MyBatis？

1.1 传统 JDBC 的局限性

在JDBC时代，写一段数据访问代码，得自己动手干多少活呢？首先，你得手动创建数据库连接池DataSource，再费劲地获取一个Connection；接着，写SQL时得小心翼翼地用?占位符，然后一个一个地手动绑定参数；等到查询结果回来，还得手动从ResultSet里把数据“拽”出来，再映射到Ja va对象身上；最后，千万别忘了在finally块里把资源一个个关掉。这一整套流程，简直就是“模板代码”的流水线，不仅开发效率低得令人发指，更是一不小心就容易捅出资源泄露的娄子。

1.2 MyBatis 的优势

MyBatis作为一款久经考验的持久层框架，它瞄准的就是上面那些痛点。其核心优势很清晰：简化交互，让开发者与数据库打交道的代码量直线下降；解耦SQL，允许你把SQL从Ja va代码中搬出来，放到独立的XML文件里，管理起来清爽很多；还有灵活映射，它能自动把SQL查询结果集和我们定义的Ja va实体类关联起来，省去大量手动转换的麻烦。

2. 环境搭建与核心配置

2.1 依赖引入

要开始干活，首先得在pom.xml里把依赖导入。核心就是MyBatis的Spring Boot起步依赖，外加一个MySQL驱动。版本嘛，记得选一个适合你项目的稳定版。

    org.mybatis.spring.boot
    mybatis-spring-boot-starter
    3.0.3


    com.mysql
    mysql-connector-j
    runtime

2.2 开启 SQL 执行日志

调试阶段，能把SQL打印出来看看是最方便的。在配置文件里加上一行配置，就能开启MyBatis内置的日志实现，控制台上会实时输出每条执行的SQL语句，非常直观。

mybatis:
  configuration:
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl # 输出 SQL 到控制台

3. MyBatis 开发实战（双模式详解）

3.1 注解开发模式（适用于简单查询）

对于简单的增删改查，注解模式是最直接的选择。只需要定义一个@Mapper接口，然后在方法上贴上对应的SQL注解即可。查询用@Select，插入用@Insert，配合@Options(useGeneratedKeys = true, keyProperty = "id")，还能优雅地拿到自增主键。

@Mapper
public interface UserInfoMapper {
    // 根据 ID 查询用户
    @Select("select * from user_info where id = #{id}")
    UserInfo queryById(Integer id);
    // 插入并返回自增主键 ID
    @Insert("insert into user_info (username, password) values (#{username}, #{password})")
    @Options(useGeneratedKeys = true, keyProperty = "id")
    Integer insert(UserInfo userInfo);
}

3.2 XML 映射模式（适用于复杂业务）

当业务逻辑变得复杂，比如要做多表联查、动态SQL拼接，XML模式就显露出它的优势了。我们可以把SQL统一写在映射文件里，通过命名空间与Mapper接口绑定。结果映射用resultMap定义，非常灵活。

    
        
        
    
    
        select * from user_info
    

4. 核心原理：#{} 与 ${} 的本质区别

这部分堪称面试中的“常客”，也是不少新手容易踩坑的地方。先看一组对比：

简单来说，#{}走的是预编译路径，用?占位，数据库会对SQL模板进行解析和优化，后续相同的SQL只需传入不同的参数值，执行计划可以复用，性能高且能有效防范SQL注入。而${}则是简单粗暴的字符串替换，直接把参数值“塞”进SQL语句里，如果参数来自用户输入，那就等于给攻击者开了后门。因此，除了表名、列名这类无法预编译的少数场景，日常开发中应当无条件优先使用#{}。

5. 多表关联查询进阶

多表查询对MyBatis而言，并不是什么新鲜事。归根结底，它处理的是SQL查询的结果集，并把结果映射到Ja va对象上。不管是单表还是多表联查，只要把SQL写对，把映射关系定义清楚，剩下的就交给MyBatis去处理。下面这个例子，就是通过左连接把文章信息和用户信息关联起来。

@Select("SELECT ta.id, ta.title, tb.username FROM articleinfo ta LEFT JOIN user_info tb ON ta.uid = tb.id WHERE ta.id = #{id}")
ArticleInfo queryUserByUid(Integer id);

6. 企业级规范与优化建议

6.1 数据库命名规范

在企业级项目中，规范往往比代码本身更重要。一个常见的约定是：蛇形命名，即表名和字段名统一使用小写，单词间用下划线分隔，比如user_info、delete_flag。同时，配合MyBatis的驼峰转换配置，就能自动将数据库中的abc_xyz映射为Ja va实体里的abcXyz，省去手动处理的麻烦。

6.2 Druid 连接池配置

如果项目需要更强大的连接池监控功能，可以考虑引入阿里巴巴的Druid连接池。它提供了丰富的监控面板和SQL分析能力，对排查性能问题非常有帮助。

    com.alibaba
    druid-spring-boot-3-starter
    1.2.21

7. 总结

MyBatis通过简洁的配置与灵活的SQL映射，极大提升了Ja va开发的效率。在实际项目中，注解模式适合快速原型和简单的CRUD，XML模式则更适合复杂查询和动态逻辑。无论选择哪种方式，安全这根弦不能松，始终把#{} 作为第一选择。希望这份实战指南能帮助你更顺畅地搭建自己的持久层。

读者互动区

投票：你在开发中更倾向于使用哪种 MyBatis 模式？

• A. 纯注解开发，简单快捷
• B. 全 XML 映射，逻辑解耦
• C. 混合使用，视复杂度而定

• MyBatis 官方文档
• Alibaba Druid 配置指南