MyBatis中的 10 个宝藏技巧！

2026-08-04 10:59

阅读156

2026-08-04 10:59

阅读 156

前言说到 MyBatis，很多小伙伴都会用，但未必用得“惊艳”。实际上，这个轻量级的持久层框架还有很多隐藏的“宝藏技巧”。如果你能掌握这些技巧，不但能让开发更高效，还能避免掉入一些常见的“坑”。今天就从浅入深，分享 10 个让人眼前一亮的 MyBatis 开发技巧，每一个都配上具体的场景和代码示例，务求通俗易懂，希望对你会有所帮助。

灵活使用动态 SQL

很多小伙伴在写 SQL 的时候，喜欢直接用拼接字符串的方式，比如： String sql = "SELECT * FROM user WHERE 1=1";if (name != null) { sql += " AND name = '" + name + "'";} 这种写法不仅麻烦，而且安全性很差（容易引发 SQL 注入）。 MyBatis 的动态 SQL 是专门为解决这种问题设计的，你可以用 if、choose、foreach 等标签来动态构造 SQL。

示例：动态条件查询 SELECT * FROM user WHERE 1=1 AND name = #{name} AND age = #{age} 这个代码的好处是，SQL 逻辑清晰，不会因为某个参数为空就导致整个 SQL 报错。顺便吆喝一声，民族企业[color=rgb(54, 115, 254) !important]机会，前、后端/测试缺人，待遇给的还可以哦~ [color=rgb(54, 115, 254) !important]

2. 善用 resultMap 自定义结果映射 有些小伙伴会遇到这样的问题：数据库表字段是下划线命名，但 Java 对象是驼峰命名。比如 user_name 对应 userName。如果直接用默认的 resultType，MyBatis 是无法自动映射的。这个时候，用 resultMap 就能完美解决。示例：自定义结果映射 SELECT id, user_name, age FROM user WHERE id = #{id} 有了 resultMap，再复杂的字段映射都可以轻松搞定。

3. 利用 foreach 实现批量操作 有些小伙伴可能会遇到这种需求：传入一个 ID 列表，查询所有匹配的用户信息。如果用拼接字符串的方式生成 IN 条件，不但代码丑，还容易踩坑。 MyBatis 提供了 foreach 标签，可以优雅地处理这种场景。示例：批量查询 SELECT * FROM user WHERE id IN #{id} 传入的 idList 是一个 List 或数组，MyBatis 会自动帮你展开为 IN (1, 2, 3) 这样的格式，完全不用担心语法问题。

4. MyBatis-Plus 的分页功能 很多小伙伴在做分页的时候，习惯自己写 LIMIT 的 SQL，这样不仅麻烦，还容易出错。其实，用 MyBatis-Plus 的分页插件能省不少事。示例：MyBatis-Plus 分页功能 Page page = new Page<>(1, 10); // 第 1 页，每页 10 条IPage userPage = userMapper.selectPage(page, null);System.out.println("总记录数：" + userPage.getTotal());System.out.println("当前页数据：" + userPage.getRecords()); 只需引入分页插件，就能轻松完成分页操作，简直不要太爽。

5. 使用 @Mapper的接口代理 有些小伙伴觉得 XML 文件太多太麻烦，其实 MyBatis 支持纯注解的开发模式，尤其是对于简单的 SQL，非常方便。示例：注解方式查询 @Mapperpublic interface UserMapper { @Select("SELECT * FROM user WHERE id = #{id}") User getUserById(int id); @Insert("INSERT INTO user(name, age) VALUES(a class="linkToSearch" target="_blank" href="/platform/searchResult?k=%23%7Bname%7D%2C%26nbsp%3B%23&c=2" style="color:rgb(24,113,255);font-weight:600;padding:0 5px">#{name}, #{age})") void addUser(User user);} 用这种方式，可以完全省掉 XML 配置，代码更加简洁。

6. 二级缓存 MyBatis 内置了一级缓存（SqlSession 范围内），但对于多次查询的场景，可以开启二级缓存来提升性能。示例：开启二级缓存 SELECT * FROM user WHERE id = #{id} 开启二级缓存后，同一个 Mapper 下的查询会自动命中缓存，大幅提高性能。

总结 MyBatis 的魅力在于简单、高效，但很多时候我们用得太“基础”，没有发挥它的全部潜力。希望这些技巧能帮你更高效地使用 MyBatis，也让你的代码看起来更“惊艳”。如果觉得有帮助，记得收藏分享！

最后说一句 如果这篇文章对您有所帮助，或者有所启发的话，帮忙关注一下我的同名公众号：苏三说技术，您的支持是我坚持写作最大的动力。求一键三连：点赞、转发、在看。 ——转载自：苏三说技术