`getbyid`直接根据id查询实体，不存在时抛出异常；`getone`则基于条件查询单条记录，不匹配时返回null——二者语义、行为和适用场景均不同，不可简单等价替换。
在Spring Boot + MyBatis-Plus开发中，初学者常误认为 getById(id) 和 getOne(wrapper) 是功能等价的查询方式，尤其当 wrapper 仅设置 eq(ID, id) 时。但二者底层逻辑与契约语义存在本质差异，直接影响程序健壮性与错误处理策略。
? 核心区别解析
| 方法 | 底层行为 | 无匹配时行为 | 是否触发数据库查询 | 适用场景 |
|---|---|---|---|---|
| getById(id) | 调用 selectById，走主键索引精准查询 | 抛出 IllegalArgumentException（若ID为null）或返回null（取决于版本），MyBatis-Plus 3.4.0+ 默认配置下实际返回null；但更关键的是：它明确语义为“按主键加载”，业务上隐含“该ID应存在”前提 | ✅ 真实执行SQL（如 SELECT * FROM category WHERE id = ?） | 已确认ID合法且预期必然存在（如前端传参校验后），需强一致性保障 |
| getOne(wrapper) | 构造动态WHERE条件，执行 SELECT * FROM ... WHERE ... LIMIT 1 | 严格返回null（即使表中有数据但条件不匹配） | ✅ 真实执行SQL | 条件不确定、允许“查无结果”的柔性场景（如模糊筛选、关联查询补全） |
⚠️ 注意：你遇到的 getOne(...) 返回 null 并非Bug，而是设计使然——只要数据库中无满足 id = categoryId 的记录（例如ID不存在、被软删除、事务未提交），它就返回 null；而 getById 在多数项目配置下同样返回 null，但关键差异在于语义与可维护性。
✅ 正确实践建议
-
优先使用 getById(id) 获取主键实体：语义清晰、性能最优（走主键索引）、代码意图一目了然。
try { Category category = categoryService.getById(categoryId); if (category == null) { throw new BusinessException("分类不存在，ID：" + categoryId); } String categoryName = category.getCategoryName(); // 安全获取字段 } catch (Exception e) { // 统一处理ID非法或系统异常 } 慎用 getOne(wrapper) 替代主键查询：除非你主动需要“条件化单查”（如 eq("status", 1).eq("tenant_id", tenantId)），否则增加不必要的条件解析开销，且弱化了主键查询的语义表达。
-
若需仅查单个字段（如 categoryName）提升性能，推荐使用自定义Mapper方法，避免加载整行：
// CategoryMapper.java @Select("SELECT category_name FROM category WHERE id = #{id}") String getCategoryNameById(Long id);或使用 MyBatis-Plus 的 LambdaQueryWrapper 配合 select() 指定列（需配合 getObj()）：
String name = categoryService.getObj( new LambdaQueryWrapper() .select(Category::getCategoryName) .eq(Category::getId, categoryId), Category::getCategoryName );
? 总结
getById 和 getOne 不是等价替代品，而是面向不同抽象层级的API：前者是主键加载契约，后者是条件单查契约。选择依据不应是“是否返回null”，而应是业务语义是否要求“必须存在”。统一使用 getById 可提升代码可读性、降低隐式空指针风险，并为后续集成乐观锁、缓存等机制预留清晰扩展点。
