最优雅的方式是用Optional封装可能为空的返回值，强制调用方处理“无值”语义；配合Objects.requireNonNull校验入参、空集合替代null、枚举或Null Object模式建模业务“无”，从设计源头减少null。
Java 中处理 null 值最优雅的方式，不是堆砌 if (obj != null) 判断，而是通过设计让 null 从源头减少、用工具规避、用语义明确的替代方案表达“无值”意图。
优先用 Optional 封装可能为空的返回值
Optional 不是为取代所有 null 而生，而是专用于明确表达“可能没有结果”的方法返回值。它把空值检查从调用方转移到声明方，强制调用者思考“如果没有怎么办”。
- 服务层方法返回 Optional
，而不是 User（避免调用方忘记判空） - 链式调用安全：userRepo.findById(id).map(User::getProfile).orElse(new Profile())
- 避免 Optional 作为字段或参数——它不可序列化，且会掩盖真实业务语义
用 Objects.requireNonNull 和 requireNonNullElse 统一校验入口
对入参或关键依赖项，在方法开头就做明确、可读、可追溯的非空断言，比散落各处的 if 判空更清晰。
sc-java-to-ts-interface
下载
将后端 Java 接口文档转换为前端 TypeScript 类型定义（interface / type）。输入：飞书文档、Spring Boot 接口文档、Swagger/OpenAPI、手写 API 文档等。输出：包含请求参数与响应结果的 .md 文件，含完整 JSDoc 注释。触发关键词：Java 转 TS、接口转换、生成前端类型、接口文档转 TypeScript、DTO/VO/BO 转 interface、后端文档转前端类型、生成接口类型、类型定义生成。
- Objects.requireNonNull(name, "用户名不能为空") —— 抛出带提示的 NullPointerException
- Objects.requireNonNullElse(config, defaultConfig) —— 提供默认值，适用于配置类等场景
- 配合 Lombok 的 @NonNull 注解 + @RequiredArgsConstructor，编译期+运行期双重防护
用空集合/空字符串代替 null 作为容器型返回值
集合、Map、StringBuilder 等类型，永远返回空实例而非 null，能直接遍历、调用方法，彻底消除判空负担。
- DAO 方法返回 Collections.emptyList() 或 new ArrayList()，而非 null
- StringUtils.isBlank(str) 比 str != null && str.trim().isEmpty() 更简洁安全
- Guava 的 ImmutableList.of()、ImmutableMap.of() 天然不可空、不可变，适合常量或配置
用枚举或专门的空对象（Null Object Pattern）表达业务上的“无”
当 null 实际代表一种业务状态（如“未激活”、“暂无权限”），用类型系统显式建模，比原始 null 更易维护、可扩展。
- 定义枚举 Status { ACTIVE, INACTIVE, PENDING, UNDEFINED }，UNDEFINED 替代 null
- 为接口提供 NullUser implements User，其 getName() 返回 "未知用户"，避免上层空指针
- Spring 的 @Nullable/@NonNull 注解 + IDE 静态检查，提前暴露潜在空值路径
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
