MyBatis 返回 null 的根本解法是分层拦截与语义明确：Mapper 层强制返回非 null 集合（如 List<T>），Service 层对单对象用 Optional 包装，Controller 层统一返回 Collections.emptyList()，并启用 callSettersOnNulls 确保 NULL 字段可安全映射。
MyBatis 返回 null 是常见但可控的问题，关键不在“堵”，而在“疏”——提前明确语义、统一约定、分层拦截。最稳妥的做法是：让空值不落地、不传递、不裸用。
Mapper 层：强制返回集合，禁用 null 结果
MyBatis 默认对 selectList 类型方法保证返回非 null 集合（空 ArrayList），但前提是接口声明必须是 List<T>，不是 T 或 Object。若写成：
-
User selectById(Long id);→ 查不到就返回null，高危 -
List<User> selectById(Long id);→ MyBatis 自动返回Collections.emptyList()，安全
即使业务上“只查一个”，也建议用 List<User> selectById(Long id) + get(0)（配合判空或 stream().findFirst()），避免 null 透传。
Service 层：对单对象查询做 Optional 包装
当确实需要返回单个对象（如 selectOne 或主键查询），不要让 Controller 直接接收 null。应在 Service 层兜底：
立即学习“Java免费学习笔记（深入）”；
return Optional.ofNullable(userMapper.selectByPrimaryKey(id));- 调用方用
.orElse(null)、.orElseThrow()或.ifPresent()显式处理分支，语义清晰 - 避免
Optional.get()—— 它和直接用user.xxx()一样危险
Controller 层：空集合统一用 Collections.emptyList()
Controller 返回 JSON 时，若数据为空，别 new ArrayList<>()，直接用：
return ResponseEntity.ok(Collections.emptyList());- 它内存零开销、线程安全、不可变，Jackson 序列化结果仍是
[] - 比 new 出来再清空更轻量，也避免后续误 add() 导致
UnsupportedOperationException
XML / 注解配置：启用 callSettersOnNulls
当使用 resultType="hashmap" 或自定义 Map 封装时，数据库字段为 NULL 可能导致 key 缺失，引发 NPE。在 Spring Boot 中添加：
mybatis.configuration.call-setters-on-nulls=true- 这样 MyBatis 会把
NULL字段也 put 进 Map，值为null，便于后续用Objects.nonNull()或Map.getOrDefault()安全处理
