避免npe需设计前置：用optional表达可选语义、入口fail-fast校验、返回空集合而非null、字面量左置比较、注解标注空约束、拆解链式调用、工具类判空、构造即完整、空对象替代null、测试覆盖null边界。
避免 NullPointerException（NPE）不是靠运气，而是靠设计意识和编码纪律。真正高段位的做法，是把空值风险从运行时前移到编译期、设计期甚至API契约层——让问题根本没机会发生。
用Optional明确表达“可能没有”
Optional 不是用来包装所有返回值的装饰品，而是契约语言。只在业务语义上天然允许缺失的场景使用它，比如 findUserById(123) 可能查不到用户。声明为 Optional<user></user> 后，调用方必须显式处理 isPresent()、orElse() 或 ifPresent()，无法假装它一定存在。别把它塞进字段或参数里，那会破坏语义清晰性。
参数校验必须在方法入口就“fail-fast”
所有对外暴露的方法（尤其是 public 接口），第一行就该是 Objects.requireNonNull(input, "input must not be null")。这不是防御，是契约强制。它让错误出现在调用栈最浅层，堆栈信息干净，调试成本最低。别等走到第 15 行才因 input.getName() 崩溃——那时你已丢失上下文。
集合/数组永远不返回 null，只返回空实例
返回 null 给调用方留下的只有困惑和 if 判空。统一用 Collections.emptyList()、Collections.emptyMap() 或 new String[0]。这样客户端代码可直接写 for (Item i : service.getItems()) { ... }，无需任何前置判空。这是 API 设计最基本的尊重。
字符串比较永远把字面量放左边
"admin".equals(role) 安全；role.equals("admin") 危险。因为字面量字符串由 JVM 保证非 null，而变量 role 可能来自数据库、HTTP 参数或配置项，不可信。这条规则简单、零成本、效果立竿见影，应刻进肌肉记忆。
用注解把空约束“写进代码文档”
在参数、返回值、字段上加上 @NonNull（如 JetBrains 或 Checker Framework 提供）或 @Nullable。IDE 和静态分析工具（如 IntelliJ、SpotBugs）能据此标出潜在 NPE 路径。这不是运行时检查，但能让空值问题在你敲下分号前就被发现——比测试更早，比调试更快。
拒绝链式调用陷阱：拆解深路径访问
order.getCustomer().getAddress().getZipCode() 是 NPE 高发区。要么用 Optional 分步 map：Optional.ofNullable(order).map(Order::getCustomer).map(Customer::getAddress).map(Address::getZipCode).orElse("N/A")；要么重构模型，让关键路径收口（如 order.getShippingZipCode()），把空逻辑封装在领域内，而非暴露给调用方。
用工具类替代手写 null 判空
别再写 if (str != null && !str.trim().isEmpty())。用 Apache Commons Lang 的 StringUtils.isNotBlank(str)，或 Spring 的 StringUtils.hasText(str)。这些方法内部已做 null 安全处理，语义清晰，且经过大量生产验证。同理，集合判空用 CollectionUtils.isEmpty(list)，而不是 list != null && list.isEmpty()。
构造即完整：对象创建后必须处于可用状态
避免提供无参构造器 + 多个 setter 的松散初始化方式。优先使用全参构造器、Builder 模式或 record（Java 14+）。确保对象一旦 new 出来，所有必需字段都已赋值、非 null。null 字段不是“还没设置”，而是设计缺陷——它让每个 getter 都变成潜在的 NPE 引信。
空对象模式替代 null 返回
当某个服务方法本应返回一个策略、处理器或配置对象，但当前上下文不适用时，不要返回 null。定义一个 NoOpStrategy 或 DefaultConfig 实现，它的方法体为空或返回安全默认值。调用方可无条件调用 strategy.execute()，彻底消除判空分支，代码更平滑，意图更清晰。
测试必须覆盖 null 边界
单元测试不能只测 happy path。对每个接受引用类型参数的方法，至少补充一个用 null 调用的测试用例，并断言它抛出预期异常（如 IllegalArgumentException）或返回合理默认值。用 @Test(expected = NullPointerException.class) 或 assertThrows 显式验证失败行为——这既是测试，也是活文档。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
