1. 从“手写SQL”到“声明式操作”为什么我们需要TKMybatis如果你和我一样在Java后端开发中与MyBatis打交道多年一定经历过这样的场景一个简单的用户表需要实现增、删、改、查、分页、条件查询。于是你开始埋头苦干先写一个UserMapper.xml里面塞满了select,insert,update,delete标签。接着在UserMapper.java接口里为每个XML中的SQL ID定义一个方法。然后在UserService里注入Mapper调用这些方法。最后你发现仅仅为了一个简单的根据ID查询你就写了将近20行代码接口方法、XML SQL、Service调用。更头疼的是当表结构增加一个字段时你需要同步修改实体类、修改所有相关的插入和更新SQL、修改查询结果的映射……这种重复、繁琐、易错的“体力劳动”在项目初期或中小型项目中尚可忍受一旦业务复杂、表数量激增就会成为维护的噩梦。正是在这种背景下TKMybatis也称为通用Mapper应运而生。它不是一个全新的ORM框架而是构建在经典MyBatis之上的一个强力“扩展包”或“工具集”。它的核心思想是对于单表绝大部分的通用操作我们不应该、也不需要去手写SQL。通过继承一个预设好的通用Mapper接口你的实体类Mapper就能自动拥有数十个常用的单表操作方法如根据主键查询、根据条件查询列表、插入一条数据选择性插入、根据主键更新选择性更新、根据条件删除等。这就像给你的MyBatis装上了一套“自动驾驶”系统让你从重复的SQL编写中解放出来将精力真正聚焦在复杂的业务逻辑和多表关联查询上。简单来说TKMybatis解决的核心痛点是“单表操作的代码冗余”。它通过反射读取实体类的注解如Id,Column在运行时动态生成对应的SQL语句。你只需要定义好实体类并让你的Mapper接口继承MapperT剩下的“增删改查”基础工作就交给它吧。接下来我将带你深入TKMybatis的世界从原理、集成、使用到避坑完整地走一遍。2. TKMybatis的核心架构与工作原理剖析要熟练使用一个工具理解其背后的运行机制至关重要。TKMybatis并非魔法它的高效源于一套精巧的设计。我们可以将其核心架构分为三层接口层、代理层和SQL生成层。2.1 接口层约定大于配置TKMybatis提供了一系列标记接口Marker Interface其中最重要的是MapperT。这是一个泛型接口T代表你的实体类类型例如User。这个接口本身没有实现任何方法但它内部通过Java泛型和MyBatis的机制定义了大量默认方法的“契约”。当你创建自己的UserMapper并继承MapperUser时你实际上声明了“我的UserMapper需要拥有MapperT接口所约定的所有能力”。这些能力对应着一个个具体的方法签名例如T selectByPrimaryKey(Object key): 根据主键查询。ListT selectAll(): 查询全部数据。int insert(T record): 插入一条记录所有字段。int updateByPrimaryKey(T record): 根据主键更新所有字段。int deleteByPrimaryKey(Object key): 根据主键删除。ListT selectByExample(Object example): 根据条件查询。这些方法名和参数类型是固定的这就是“约定”。TKMybatis的后续流程正是基于这些约定来工作的。2.2 代理层MyBatis插件与动态注册这是TKMybatis的“魔法”发生地。它主要依靠两个MyBatis的核心扩展点MapperScannerConfigurer和MapperFactoryBean在Spring集成中。MapperScannerConfigurer这是一个Spring的Bean后置处理器。它的作用是在Spring容器初始化时扫描指定包路径下所有继承了MapperT的接口。对于扫描到的每一个接口如UserMapper它并不会去找一个现成的实现类而是会向Spring容器注册一个特殊的MapperFactoryBean。MapperFactoryBean这是一个FactoryBean。它的getObject()方法返回的不是它自己而是一个动态代理对象。这个代理对象实现了你的UserMapper接口。当你调用userMapper.selectByPrimaryKey(1)时调用会被这个代理对象拦截。2.3 SQL生成层反射、注解与模板引擎代理对象拦截到方法调用后需要知道该执行什么样的SQL。这就是SQL生成层的任务。方法解析代理层首先解析被调用的方法名例如selectByPrimaryKey。TKMybatis内部维护了一个“方法名”到“SQL模板类型”的映射关系。它知道selectByPrimaryKey对应的是一个“根据主键查询”的SQL操作。实体类元数据解析接下来它通过反射分析泛型T即User类。它会查找类上的注解Table(name “user_table”): 告诉TKMybatis实体类对应的数据库表名。Id: 标记主键字段。Column(name “user_name”): 标记字段对应的数据库列名。如果没加默认使用字段名驼峰转下划线。GeneratedValue(strategy GenerationType.IDENTITY): 标记主键为自增这会影响insert操作是否要获取自增ID。动态SQL组装根据方法类型和实体类元数据TKMybatis会使用内置的模板引擎或字符串拼接动态生成最终的SQL语句。例如对于userMapper.selectByPrimaryKey(1)结合User类有Id注解的id字段生成的SQL会是SELECT id, user_name, ... FROM user_table WHERE id ?。参数1会被设置到预编译语句中。委托执行生成的SQL和参数最终会通过MyBatis原生的SqlSession去执行并将结果映射回User对象。对你而言整个过程就像调用了一个已经实现好的方法一样。提示TKMybatis的SQL生成是动态的、基于反射的这意味着它有一点点运行时开销。但在绝大多数业务场景下这点开销与它带来的开发效率提升相比完全可以忽略不计。它的设计非常巧妙完全遵循了MyBatis的生态没有破坏性你可以同时使用TKMybatis的通用方法和自定义的XML/注解SQL它们可以和谐共存。3. 从零开始在Spring Boot项目中集成TKMybatis理论讲完了我们动手实践。假设我们有一个全新的Spring Boot项目需要集成TKMybatis和MySQL。以下是详细的步骤和每一步的考量。3.1 环境准备与依赖引入首先在项目的pom.xml中添加必要的依赖。这里要注意版本兼容性我以当前主流稳定版本为例dependencies !-- Spring Boot Starter -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-test/artifactId scopetest/scope /dependency !-- MyBatis Spring Boot Starter -- dependency groupIdorg.mybatis.spring.boot/groupId artifactIdmybatis-spring-boot-starter/artifactId version2.3.0/version !-- 请使用最新稳定版 -- /dependency !-- TK Mybatis (通用Mapper) Starter -- !-- 注意groupId 可能是 tk.mybatis也可能是 com.github.pagehelper -- dependency groupIdtk.mybatis/groupId artifactIdmapper-spring-boot-starter/artifactId version2.1.5/version !-- 请使用最新稳定版 -- /dependency !-- MySQL 驱动 -- dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId scoperuntime/scope /dependency !-- Lombok (可选用于简化实体类getter/setter) -- dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependency /dependencies关键点解析mybatis-spring-boot-starter这是MyBatis官方提供的Spring Boot集成包自动配置了SqlSessionFactory、DataSource等。mapper-spring-boot-starter这是TKMybatis的Spring Boot启动器。它内部已经包含了mapper核心包和pagehelper分页插件如果不需要分页也有不带pagehelper的版本。强烈建议使用这个Starter它能帮你自动完成绝大部分配置避免手动配置MapperScannerConfigurer的繁琐。版本选择务必去Maven中央仓库查看这些依赖的最新稳定版本避免因版本冲突导致启动报错。3.2 数据源与MyBatis基础配置在application.yml或application.properties中配置数据库连接和MyBatis的基本属性。这里以YAML格式为例spring: datasource: url: jdbc:mysql://localhost:3306/your_database?useUnicodetruecharacterEncodingutf-8useSSLfalseserverTimezoneAsia/Shanghai username: root password: your_password driver-class-name: com.mysql.cj.jdbc.Driver hikari: # 使用HikariCP连接池Spring Boot默认 connection-timeout: 30000 maximum-pool-size: 20 mybatis: # 配置实体类别名包这样在XML里可以直接写类名不用写全限定名 type-aliases-package: com.yourcompany.yourproject.entity # 配置XML映射文件的位置 mapper-locations: classpath:mapper/*.xml configuration: # 开启驼峰命名自动映射数据库user_name字段映射到Java的userName属性 map-underscore-to-camel-case: true # 打印SQL日志开发环境非常有用 log-impl: org.apache.ibatis.logging.stdout.StdOutImpl # TK Mybatis 配置 mapper: # 设置通用Mapper的基准接口通常不需要改 mappers: tk.mybatis.mapper.common.Mapper # 主键自增回写方法执行顺序, 默认AFTER可选BEFORE identity: MYSQL # 设置是否支持方法上的注解默认false。开启后可以使用RegisterMapper注解 enable-method-annotation: false配置详解mybatis.type-aliases-package这个配置让MyBatis自动扫描指定包下的类并为它们注册一个简短的别名默认是类名。这样在你自己写的XML映射文件中resultType就可以直接写User而不是com.yourcompany.entity.User。mybatis.configuration.map-underscore-to-camel-case: true这是一个极其重要的配置。它开启了MyBatis的自动驼峰命名映射。数据库字段名通常是user_name而Java实体属性是userName。开启此选项后MyBatis会自动进行这种映射你就不需要在resultMap或Result注解中逐个字段指定了。TKMybatis生成的SQL查询结果也依赖此规则进行映射。mybatis.configuration.log-impl设置为StdOutImpl可以在控制台打印出执行的SQL语句和参数是调试和学习的利器。生产环境建议关闭或使用更专业的日志框架配置。mapper.mappers指定通用Mapper的基准接口。如果你的项目有自定义的通用接口比如BaseMapper可以在这里添加。3.3 定义实体类与Mapper接口现在我们来创建核心的领域对象和它的数据访问接口。实体类User.java:package com.yourcompany.yourproject.entity; import lombok.Data; import javax.persistence.*; import java.util.Date; Data // Lombok注解自动生成getter, setter, toString等方法 Table(name user) // 指定对应的数据库表名。如果表名和类名一致忽略大小写可省略 public class User { Id // 标记该字段为主键 GeneratedValue(strategy GenerationType.IDENTITY) // 主键自增策略对应MySQL的AUTO_INCREMENT private Long id; Column(name username) // 指定对应数据库列名。如果字段名和列名遵循驼峰转下划线规则可省略 private String username; private String password; // 未加Column默认映射到password列 private String email; Column(name create_time) private Date createTime; Column(name update_time) private Date updateTime; // 其他字段... // 注意实体类中最好有一个无参构造函数MyBatis反射创建对象时需要。 }关键注解说明Table非必须但建议加上。明确指定表名避免因表名不规范如带前缀t_导致映射失败。Id必须。标记主键字段。TKMybatis的selectByPrimaryKey、updateByPrimaryKey等方法都依赖它来识别主键。GeneratedValue对于自增主键强烈建议加上。它告诉TKMybatis在执行insert操作后需要通过Statement.getGeneratedKeys()获取数据库生成的主键值并回填到实体对象的id字段中。如果没有这个注解插入后实体对象的id仍然是null。Column当数据库列名与实体字段名不满足驼峰转下划线规则时使用。例如字段是userName列名是user_name由于开启了map-underscore-to-camel-case可以不写。但如果列名是user_name_abc就必须用Column(name “user_name_abc”)显式指定。Mapper接口UserMapper.java:package com.yourcompany.yourproject.mapper; import com.yourcompany.yourproject.entity.User; import org.apache.ibatis.annotations.Mapper; import tk.mybatis.mapper.common.Mapper; Mapper // Spring Boot的注解声明这是一个MyBatis的Mapper会被自动扫描并注入 public interface UserMapper extends MapperUser { // 在这里你已经继承了数十个通用方法 // 你也可以在这里定义自己的、需要复杂SQL的方法。 // 例如 // ListUser selectComplexUsersByCondition(Param(condition) SomeCondition condition); }至此集成工作就完成了。启动你的Spring Boot应用如果没有报错那么UserMapper就已经被成功注册到Spring容器中你可以通过Autowired注入它并直接使用那些通用方法了。4. TKMybatis常用方法实战与深度解析集成成功后我们来看看UserMapper现在具体拥有了哪些“超能力”。MapperT接口提供了非常丰富的方法我们可以将其分为几个大类来理解和运用。4.1 基础CRUD操作这些方法是最常用、最核心的。插入操作int insert(T record)插入一条记录所有字段都会参与插入即使属性为null在SQL中也会被设置为NULL。这可能导致数据库的NOT NULL约束报错。int insertSelective(T record)推荐使用。选择性插入。只会插入属性值不为null的字段。这对于有默认值的字段非常友好。User user new User(); user.setUsername(张三); user.setEmail(zhangsanexample.com); // password, createTime 等字段为 null userMapper.insert(user); // SQL: INSERT INTO user (id, username, password, email, create_time, update_time) VALUES (null, 张三, null, zhangsanexample.com, null, null); // 如果password字段在数据库是NOT NULL这里就会报错。 userMapper.insertSelective(user); // SQL: INSERT INTO user (username, email) VALUES (张三, zhangsanexample.com); // 只插入非null字段安全。查询操作T selectByPrimaryKey(Object key)根据主键查询单条记录。key的类型必须与Id标记的字段类型一致。ListT selectAll()查询表中所有记录。慎用数据量大时会导致内存溢出。T selectOne(T record)根据实体中的非空属性进行等值查询返回一条记录。如果根据条件匹配到多条会抛出异常。适用于根据唯一键如用户名、邮箱查询。ListT select(T record)根据实体中的非空属性进行等值查询返回列表。// 1. 根据ID查询 User user userMapper.selectByPrimaryKey(1L); // 2. 根据用户名查询假设username是唯一键 User query new User(); query.setUsername(张三); User user userMapper.selectOne(query); // 返回一个User对象 // 3. 根据状态查询多个用户 User query new User(); query.setStatus(1); // 假设有个status字段 ListUser activeUsers userMapper.select(query);更新操作int updateByPrimaryKey(T record)根据主键更新所有字段都会参与更新null值会覆盖数据库原有值。int updateByPrimaryKeySelective(T record)推荐使用。根据主键选择性更新。只更新属性值不为null的字段。User user new User(); user.setId(1L); user.setEmail(new_emailexample.com); // 其他字段为null userMapper.updateByPrimaryKey(user); // SQL: UPDATE user SET usernamenull, passwordnull, emailnew_emailexample.com, ... WHERE id1 // 这将把id1的用户的其他字段都设为NULL灾难 userMapper.updateByPrimaryKeySelective(user); // SQL: UPDATE user SET emailnew_emailexample.com WHERE id1 // 只更新邮箱安全。删除操作int deleteByPrimaryKey(Object key)根据主键删除。int delete(T record)根据实体中非空属性作为条件进行删除。// 根据ID删除 userMapper.deleteByPrimaryKey(1L); // 删除所有状态为0的用户软删除场景或清理数据 User query new User(); query.setStatus(0); userMapper.delete(query);4.2 条件查询的利器Example对象上面的select(T record)和delete(T record)只能做等值查询。对于更复杂的条件如LIKE,,,IN等就需要使用Example对象。这是TKMybatis中非常强大的一个功能。Example用于构造复杂的WHERE条件。它包含一个Criteria内部类用于添加条件。import tk.mybatis.mapper.entity.Example; // 创建一个Example指定要查询的实体类 Example example new Example(User.class); // 从Example中获取一个Criteria对象 Example.Criteria criteria example.createCriteria(); // 1. 添加等值条件 criteria.andEqualTo(status, 1); // 2. 添加LIKE条件模糊查询 criteria.andLike(username, %张%); // 查询用户名包含“张”的用户 // 3. 添加范围条件 criteria.andBetween(createTime, startDate, endDate); // 创建时间在某个区间 criteria.andGreaterThan(age, 18); // 年龄大于18 criteria.andLessThanOrEqualTo(score, 100); // 分数小于等于100 // 4. 添加IN条件 ListInteger statusList Arrays.asList(1, 2, 3); criteria.andIn(status, statusList); // 5. 排序 example.orderBy(createTime).desc(); // 按创建时间降序 example.orderBy(id).asc(); // 可以链式调用多个排序条件 // 6. 去重 example.setDistinct(true); // 7. 选择查询的列只查询部分字段提高性能 example.selectProperties(id, username, email); // 执行查询 ListUser userList userMapper.selectByExample(example);多条件组合一个Example可以有多个Criteria它们之间默认是AND关系。如果需要OR关系需要创建新的Criteria并使用example.or()。Example example new Example(User.class); Example.Criteria criteria1 example.createCriteria(); criteria1.andEqualTo(type, A); Example.Criteria criteria2 example.createCriteria(); criteria2.andEqualTo(type, B).andGreaterThan(level, 5); // 将两个Criteria用OR连接 typeA OR (typeB AND level5) example.or(criteria2); ListUser list userMapper.selectByExample(example);4.3 其他实用方法int selectCount(T record)/int selectCountByExample(Example example)统计数量。boolean existsWithPrimaryKey(Object key)判断主键是否存在。int insertList(List? extends T recordList)批量插入。这是非常高效的方法它会生成一条INSERT INTO ... VALUES (...), (...), ...的SQL语句性能远高于循环调用insert。ListUser userList new ArrayList(); // ... 添加多个User对象 int rows userMapper.insertList(userList);实操心得insertList方法虽然方便但需要注意数据库对单条SQL语句长度的限制如max_allowed_packet。如果列表非常大比如超过1万条建议手动分批次插入。另外使用此方法时自增主键回填可能在某些数据库或驱动下有特殊要求需要测试验证。5. 当通用方法不够时自定义SQL与TKMybatis共存TKMybatis的通用方法覆盖了80%以上的单表操作场景但总有它力所不及的时候比如复杂的多表关联查询、需要调用数据库特定函数、或者极其复杂的动态SQL。这时我们就需要回归MyBatis的本源——编写自定义SQL。好消息是TKMybatis和自定义SQL可以完美共存。你的UserMapper在继承了MapperUser的同时完全可以定义自己的方法。5.1 使用注解方式实现自定义方法对于简单的SQL可以使用MyBatis的Select、Update、Insert、Delete注解。public interface UserMapper extends MapperUser { // 通用方法... // 自定义根据邮箱后缀查询用户 Select(SELECT * FROM user WHERE email LIKE CONCAT(%, #{suffix})) ListUser selectByEmailSuffix(Param(suffix) String suffix); // 自定义更新用户最后登录时间 Update(UPDATE user SET last_login_time NOW() WHERE id #{userId}) int updateLoginTime(Param(userId) Long userId); // 自定义复杂的联表查询假设关联order表 Select(SELECT u.*, COUNT(o.id) as order_count FROM user u LEFT JOIN order o ON u.id o.user_id WHERE u.status #{status} GROUP BY u.id) ListMapString, Object selectUserWithOrderCount(Param(status) Integer status); }5.2 使用XML映射文件实现复杂SQL对于动态SQL非常复杂的情况XML是更好的选择。首先确保你的application.yml中配置了mybatis.mapper-locations指向你的XML文件目录。创建文件src/main/resources/mapper/UserMapper.xml?xml version1.0 encodingUTF-8 ? !DOCTYPE mapper PUBLIC -//mybatis.org//DTD Mapper 3.0//EN http://mybatis.org/dtd/mybatis-3-mapper.dtd !-- namespace 必须对应你的Mapper接口的全限定名 -- mapper namespacecom.yourcompany.yourproject.mapper.UserMapper !-- 自定义结果映射如果需要的话 -- resultMap idUserDetailMap typeUser extendsBaseResultMap !-- 扩展映射 -- result columnorder_count propertyorderCount/ /resultMap !-- 一个复杂的动态查询示例 -- select idselectUsersByComplexCondition resultMapUserDetailMap SELECT u.*, COUNT(o.id) as order_count FROM user u LEFT JOIN order o ON u.id o.user_id where if testusername ! null and username ! AND u.username LIKE CONCAT(%, #{username}, %) /if if testminOrderCount ! null HAVING COUNT(o.id) #{minOrderCount} /if /where GROUP BY u.id ORDER BY u.create_time DESC /select !-- 批量更新示例 (需要数据库驱动支持如MySQL的foreachcase when) -- update idbatchUpdateStatus UPDATE user SET status CASE id foreach collectionlist itemitem WHEN #{item.id} THEN #{item.status} /foreach END WHERE id IN foreach collectionlist itemitem open( separator, close) #{item.id} /foreach /update /mapper然后在UserMapper.java接口中声明对应的方法public interface UserMapper extends MapperUser { ListUser selectUsersByComplexCondition(Param(username) String username, Param(minOrderCount) Integer minOrderCount); int batchUpdateStatus(Param(list) ListUser userList); }共存机制解析MyBatis在启动时会扫描UserMapper接口。它发现这个接口继承了MapperUser同时自己也有方法定义。对于继承来的通用方法MyBatis会使用TKMybatis提供的MapperProxy代理逻辑来处理。对于自定义的方法无论是注解还是XMLMyBatis会按照自己的常规流程去找对应的SQL语句来执行。两者通过不同的MapperMethod对象区分互不干扰。重要提示如果你使用了XML文件并且开启了MyBatis的驼峰映射在编写resultMap时property名是Java属性名驼峰column名是数据库列名下划线。TKMybatis为每个实体生成了一个名为BaseResultMap的基础映射你可以通过extends”BaseResultMap”来继承它避免重复定义所有字段的映射。6. 实战避坑指南与性能优化建议用了这么久TKMybatis我也踩过不少坑。下面把这些经验教训总结出来希望能帮你绕开这些“雷区”。6.1 注解使用不当导致映射失败坑1忘记Id或GeneratedValue现象调用insert后实体对象的自增ID没有回填selectByPrimaryKey等方法报错。根因TKMybatis依赖Id识别主键。没有它selectByPrimaryKey就无法生成正确的WHERE id?语句。GeneratedValue则告诉框架在插入后去获取自增ID。解决仔细检查实体类确保主键字段正确标注了Id。如果是自增务必加上GeneratedValue(strategy GenerationType.IDENTITY)。坑2Column注解的name值写错或与数据库列名不符现象查询结果中某个字段始终为null即使数据库有值。根因框架根据Column(name“xxx”)或字段名驼峰转下划线去匹配结果集的列名。如果不匹配映射就会失败。排查打开MyBatis的SQL日志log-impl: StdOutImpl查看实际查询返回的列名与实体类中的Column注解或字段名进行比对。建议保持数据库设计规范使用下划线命名并在Java实体类中统一使用驼峰命名。开启map-underscore-to-camel-case: true可以省去大部分Column注解。对于特殊情况如列名desc是SQL关键字必须使用Column(name “desc”)注意反引号来显式指定。6.2 批量操作与分页的性能陷阱坑3滥用selectAll()和Example全表扫描现象随着数据量增长某些查询接口越来越慢甚至拖垮数据库。根因selectAll()和没有索引支持的Example查询如对非索引字段做LIKE ‘%xxx%’会导致全表扫描。解决强制分页对于列表查询永远不要直接返回全部数据。务必使用分页插件如PageHelperTKMybatis Starter通常已集成。为查询条件字段添加数据库索引特别是WHERE、ORDER BY、GROUP BY涉及的字段。使用selectProperties在Example中如果不需要所有字段用example.selectProperties(“id”, “name”)只查询必要字段减少网络传输和内存消耗。如何使用PageHelper分页// 在调用查询方法前设置分页参数。这行代码必须紧贴在Mapper方法调用之前。 PageHelper.startPage(1, 10); // 查询第1页每页10条 // 接下来执行的第一个MyBatis查询方法会被自动分页 ListUser userList userMapper.selectByExample(example); // 查询完成后可以获取分页信息 PageInfoUser pageInfo new PageInfo(userList); long total pageInfo.getTotal(); // 总记录数坑4超大列表的insertList现象批量插入几万条数据时程序报错Packet for query is too large。根因单条INSERT语句过长超过了MySQL的max_allowed_packet限制。解决在代码中进行分批插入。可以写一个工具方法public T int batchInsertInChunks(ListT list, int batchSize, FunctionListT, Integer insertFunction) { int totalRows 0; ListListT chunks Lists.partition(list, batchSize); // 使用Guava或手动分割 for (ListT chunk : chunks) { totalRows insertFunction.apply(chunk); } return totalRows; } // 调用 batchInsertInChunks(hugeUserList, 1000, userMapper::insertList);6.3 事务与乐观锁的考量TKMybatis本身不管理事务事务需要由Spring的Transactional来管理。在Service层进行多个数据库操作时务必声明事务。关于乐观锁TKMybatis没有内置的乐观锁实现如MyBatis Plus的Version注解。如果你需要乐观锁通常需要在实体类中增加一个version字段并在更新时手动控制// 1. 查询时获取当前version User user userMapper.selectByPrimaryKey(id); // 2. 更新时将version作为条件 user.setNewField(new value); user.setVersion(user.getVersion() 1); int rows userMapper.updateByPrimaryKeySelective(user); // 3. 检查rows如果为0说明数据已被他人修改需要重试或抛出异常 if (rows 0) { throw new OptimisticLockException(数据已被修改请刷新后重试); }你也可以将这套逻辑封装在自定义的通用方法或BaseService中。6.4 复杂查询与Example的局限性Example虽然强大但有其边界。它无法处理多表关联查询JOIN。嵌套查询子查询。复杂的函数计算如DATE_FORMAT,CONCAT在WHERE中。动态的GROUP BY和HAVINGExample的selectProperties和orderBy是固定的。当你的查询需求超出Example的能力时不要犹豫直接使用自定义XML SQL。这是MyBatis的强项也是TKMybatis设计哲学的一部分——通用方法解决通用问题自定义SQL解决特殊问题。两者结合才能发挥最大威力。最后TKMybatis是一个极大地提升了MyBatis开发效率的工具但它不是银弹。理解它的原理明确它的边界在合适的场景使用合适的方法才能让你的项目代码既简洁高效又灵活强大。从我个人的经验来看在中小型项目或大型项目的单表操作中TKMybatis的引入绝对是利大于弊它能让你和你的团队从大量的重复CRUD代码中解脱出来更专注于业务逻辑的实现。