本文解析mybatis-plus中`getone()`与`getbyid()`在单条记录查询中的核心差异：前者基于条件匹配返回首条结果（无匹配则返回null），后者按主键精确查询并默认抛出异常，二者语义与健壮性截然不同。
在Spring Boot + MyBatis-Plus开发中，初学者常误认为 getOne(LambdaQueryWrapper) 和 getById(ID) 是功能等价的查询方式——尤其当仅需根据主键获取单条记录时。但二者在设计意图、执行逻辑与错误处理机制上存在本质区别，直接混用可能导致空指针异常或业务逻辑静默失败。
✅ getById(ID)：主键精准查询，强契约语义
该方法专为主键查询设计，底层调用 selectById，SQL 形如：
SELECT * FROM category WHERE id = ?
- ✅ 保证按主键唯一索引查询，性能最优；
- ✅ 若数据库中不存在对应记录，MyBatis-Plus 默认抛出 NoSuchElementException（可通过全局异常处理器统一捕获）；
- ✅ 语义明确：「我要这个ID的实体，它必须存在」——适合强一致性场景（如详情页、权限校验）。
⚠️ getOne(LambdaQueryWrapper)：条件模糊匹配，弱契约语义
该方法用于任意条件查询并取第一条结果，底层执行 selectList(...).get(0)：
LambdaQueryWrapperwrapper = new LambdaQueryWrapper<>(); wrapper.eq(Category::getId, categoryId); Category category = categoryService.getOne(wrapper); // 实际执行：SELECT * FROM category WHERE id = ? LIMIT 1
- ⚠️ 即使条件字段是主键，它仍走通用条件查询流程，不利用主键索引优化（部分版本可能优化，但非保障行为）；
- ⚠️ 无匹配记录时返回 null，而非异常——若未判空即调用 category.getCategoryName()，将触发 NullPointerException；
- ⚠️ 语义隐含「找一个满足条件的，有就返回第一个，没有就算了」，不适合要求数据必然存在的场景。
? 正确实践建议
- ✅ 主键查询优先用 getById()：语义清晰、性能稳定、异常可追溯；
- ✅ 若需 getOne() 的灵活性（如多条件+分页首条），务必判空：
Category category = categoryService.getOne(wrapper); if (category == null) { throw new BusinessException("分类不存在，ID：" + categoryId); } String name = category.getCategoryName(); - ❌ 避免用 getOne() 替代 getById() 仅为了“看起来更通用”——牺牲可读性与健壮性。
? 小结：getById() 是主键查询的黄金标准，getOne() 是条件查询的通用工具。二者不可互换，选择依据不是“能不能查到”，而是“业务是否允许缺失”以及“查询意图是否精准”。
