Spring Boot + MyBatis-Plus 查询单条记录

在 Spring Boot MyBatis-Plus 中实现SELECT TOP 1即只查询一条记录的效果有多种方式。具体选择取决于你的数据库类型、查询条件的确定性以及代码风格偏好。以下是几种常见实现方法1. 使用selectOne方法适用于确定结果唯一的情况selectOne默认只返回一条记录但如果查询结果多于一条会抛出TooManyResultsException。因此它适合在业务上能保证查询结果唯一例如根据主键或唯一索引查询的场景。java// 根据条件查询单个实体 User user userService.getOne(Wrappers.UserlambdaQuery().eq(User::getName, 张三)); // 或者直接使用 mapper User user userMapper.selectOne(Wrappers.UserlambdaQuery().eq(User::getName, 张三));注意如果条件不唯一建议用下面其他方式。2. 使用last(limit 1)拼接 SQL 片段最通用MyBatis-Plus 的QueryWrapper或LambdaQueryWrapper提供了last方法可以直接在 SQL 末尾追加自定义语句。利用这一点可以加上LIMIT 1MySQL、PostgreSQL、H2 等或TOP 1SQL Server 需注意语法位置。示例适用于支持LIMIT的数据库javaUser user userMapper.selectOne( new LambdaQueryWrapperUser() .eq(User::getAge, 18) .last(LIMIT 1) // 追加 limit 1 );由于selectOne内部也会检查结果数量使用last(limit 1)后实际最多返回一条不会触发异常。针对 SQL Server 的TOP 1SQL Server 的TOP必须紧跟在SELECT之后而last方法添加的语句在 SQL 末尾直接写last(TOP 1)是无效的。此时有两种选择使用自定义 SQL见下文改用分页查询见方法 43. 使用selectListlast(limit 1)并取第一个元素如果不想处理selectOne的异常可以查询列表并取出第一个元素即使结果集为空也安全。javaListUser list userMapper.selectList( new LambdaQueryWrapperUser() .eq(User::getAge, 18) .last(LIMIT 1) ); User user list.isEmpty() ? null : list.get(0);4. 使用分页查询借助 MyBatis-Plus 分页插件MyBatis-Plus 的分页插件可以轻松实现“取第一条”的效果而且数据库兼容性好分页插件会根据方言自动生成合适的分页语句。java// 配置好分页插件后 PageUser page new Page(1, 1); // 第1页每页1条 PageUser result userMapper.selectPage(page, Wrappers.UserlambdaQuery().eq(User::getAge, 18)); User user result.getRecords().isEmpty() ? null : result.getRecords().get(0);5. 使用自定义 SQLXML 或注解对于复杂 SQL 或特殊数据库语法可以直接写原生 SQL。注解方式javaSelect(SELECT TOP 1 * FROM user WHERE age #{age}) User selectTopOneByAge(Param(age) Integer age);XML 方式xmlselect idselectTopOneByAge resultTypecom.example.entity.User SELECT TOP 1 * FROM user WHERE age #{age} /select总结如果确定条件唯一直接使用selectOne最简单。如果条件可能多条且数据库支持LIMIT推荐last(LIMIT 1)selectList或selectOne。如果使用 SQL Server用自定义 SQL 或分页插件。如果项目已启用分页插件用分页查询语义清晰且数据库无关性好。根据你的实际数据库和项目情况选择即可。