MyBatis 官方网站

Java与.NET开发者若厌倦了JDBC的冗余代码，MyBatis 3.5.16（2024年4月2日发布）让你用XML或注解直接写SQL，将结果自动映射为POJO、Map或基本类型，无需手动设置参数和遍历ResultSet。

它能做什么

MyBatis是一个持久层框架，核心能力是让开发者完全控制SQL，同时自动处理参数绑定和结果映射。

• 自定义SQL与存储过程：直接编写任意复杂度的SQL，包括存储过程调用，框架不干预SQL生成。
• 高级映射：支持将查询结果映射到POJO、Map、基本类型，以及嵌套对象和集合（如一对多、多对多）。
• 动态SQL：通过XML标签（如<if>、<where>、<foreach>）按条件拼接SQL，避免字符串拼接错误。
• 注解驱动：除XML外，可使用@Select、@Insert、@Options等注解配置SQL，减少配置文件数量。
• 类型处理器（TypeHandler）：自定义Java类型与JDBC类型的转换逻辑，例如将数据库BIT字段自动转为Java Boolean。

怎么上手

官方文档（mybatis.org）提供完整中文翻译，从入门到高级特性均有分章节指南。

• 快速开始：在项目中引入mybatis-3.5.16.jar（或Maven依赖），创建SqlSessionFactory，通过XML或注解定义映射器。
• 核心组件：SqlSessionFactoryBuilder（构造器） SqlSessionFactory（工厂） SqlSession（会话），三者分工明确。
• 映射器配置：XML映射文件或注解接口中编写SQL，通过namespace和id绑定方法。
• 动态SQL示例：使用<trim>、<set>等标签实现条件更新，避免全表字段覆盖。
• 日志集成：内置日志工厂自动按顺序查找SLF4J、Apache Commons Logging、Log4j 2、Log4j（3.5.9起废弃）、JDK logging，无需额外配置。

注意事项与版本

MyBatis 3.5.15于2023年12月14日发布，3.5.16为最新稳定版。

• 版本兼容：3.5.16支持Java 8+，与Spring Boot 2.x/3.x集成良好（通过mybatis-spring-boot-starter）。
• 废弃特性：Log4j 1.x在3.5.9起被废弃，建议迁移至Log4j 2或SLF4J。
• 空行处理：returnInstanceForEmptyRow属性（3.4.2+）可让全空行返回空实例而非null，避免空指针。
• 主键回写：useGeneratedKeys=true配合keyProperty属性，可将数据库自增主键自动赋值到实体类字段。
• 参数绑定异常：BindingException常见于参数名不匹配或类型错误，检查XML中parameterType与方法签名。

常见问题

Q1：MyBatis 3.5.16相比3.5.15有哪些更新？

A1：官方发布说明（GitHub releases）显示3.5.16主要修复了若干bug，并提升了与新版Spring的兼容性。具体变更可查看https://github.com/mybatis/mybatis-3/releases。

Q2：MyBatis的@Options注解能配置哪些功能？

A2：@Options可设置useCache（是否使用二级缓存，默认true）、fetchSize（每次获取记录数上限，默认-1无限制）、timeout（超时毫秒，默认-1）、useGeneratedKeys（是否自动生成主键，默认false）等。

Q3：MyBatis中文官方文档在哪里？

A3：官方文档中文版位于https://mybatis.org/mybatis-3/zh/，内容与英文版同步，涵盖简介、入门、XML映射、动态SQL、Java API等全部章节。

更多同类工具与网站,可在后端系统分类继续挑选。

信息核实于 2026年7月,具体以官网为准。