Java防范空指针的核心是前置拦截而非事后捕获:方法入口用Objects.requireNonNull校验参数,返回值用Optional封装并规范取值,字符串比较用常量左置或工具类,外部交互统一契约封装并避免null暴露。

Java里处理null,核心不是“怎么 catch”,而是“怎么不让它走到调用那一步”。空指针异常(NullPointerException)几乎全发生在运行时,堆栈往往指向深层方法,但根子常在上游——比如一个没校验的参数、一次没兜底的远程调用、或一句草率的字符串比较。真正有效的防范,是把null挡在门口,而不是等它闯进来再灭火。
方法入参和构造函数:用 requireNonNull 主动拦截
对明确不该为 null 的参数,别等它被用到才出错。Objects.requireNonNull 是最轻量、最清晰的断言方式,它让问题暴露在第一现场。
- 适合用在 public 方法入口、构造函数、配置初始化等关键节点
- 写法简洁:Objects.requireNonNull(user, "用户对象不能为空"),错误信息直接可读
- 配合 @NonNull 注解(如 IntelliJ 或 Lombok),IDE 能提前标出潜在风险点
- 避免滥用:不在循环体、链式调用中间、或已有 if 判空逻辑后再加 requireNonNull
返回值不确定时:优先用 Optional 封装语义
Optional 不是防 NPE 的银弹,但它强制你面对“可能为空”这个事实。重点不在包装,而在后续怎么取值。
- 用 Optional.ofNullable(result) 包装可能为 null 的返回值,比如数据库查询、远程接口
- 取值推荐写法:opt.orElse("默认值")、opt.orElseGet(() -> computeDefault())、opt.ifPresent(this::handle)
- 绝对避免 opt.isPresent() && opt.get() 这种写法,等于白包一层
- 不把 Optional 当字段类型,也不用作方法参数——它不是数据载体,是操作契约
字符串与基础类型操作:避开经典陷阱
很多 NPE 其实源于惯性写法,不是逻辑复杂,而是细节松懈。
立即学习“Java免费学习笔记(深入)”;
- 判空别写 str == null || str.equals(""),改用 StringUtils.isEmpty(str)(Apache Commons)或 TextUtils.isEmpty(str)(Android)
- 字符串比较常量放左边:"OK".equals(status),不怕 status 为 null
- 自动拆箱要警惕:Integer id = null; int value = id; 直接炸,改用 id != null ? id : 0 或 Optional.ofNullable(id).orElse(0)
- 数组判空先看引用:if (arr != null) { ... arr.length ... },不能跳过引用检查直接访问 length
外部交互场景:从协议层减少 null 暴露
远程服务、数据库、配置中心返回 null,不是代码问题,是契约模糊。防御要前移。
- 所有对外 API 统一封装 Result
,含 code、data、message 字段,data 为 null 时 code 明确标识“未找到”而非抛异常 - MyBatis 查询结果用 @Options(useActualParamName = true) + resultType,避免因字段映射失败导致整条记录为 null
- JSON 反序列化时,用 Jackson 的 @JsonInclude(JsonInclude.Include.NON_NULL) 控制输出,但入参反序列化建议设 DeserializationFeature.FAIL_ON_NULL_FOR_PRIMITIVES 提前报错
- 缓存层(如 Redis)查不到时,不返回 null,而返回空对象或特殊标记值,业务层无需每处都判空
空指针不是 bug,是信号——提醒你某处契约没说清、某次交互没兜底、某个假设太乐观。把 null 当成一种需要显式表达的状态,而不是待绕开的障碍,代码自然就稳了。


















