Optional 不适合做 API 参数校验，因其设计初衷是表达值存在的可能性而非校验输入合法性；应优先使用 Bean Validation 注解或 Objects.requireNonNull 等显式校验方式。
用 Optional 做参数校验本身不是最佳实践，它本意是为避免 null 返回值而设计的容器类，**不适合替代显式判空或校验框架**。强行用 Optional.ofNullable(param).orElseThrow(...) 虽能抛异常，但会掩盖语义、降低可读性，也违背其设计初衷。
为什么 Optional 不适合做 API 参数校验
Optional 是值存在的“可能性”抽象，不是“校验工具”。它的核心价值在于：
- 明确表达方法可能不返回结果（如
Map.get()） - 强制调用方处理“无值”场景（避免隐式
null） - 链式操作安全（
map/flatMap/filter）
而 API 参数校验关注的是：输入是否合法、缺失、越界、格式错误等，需要清晰的错误上下文（如字段名、违反规则、建议值）。用 Optional 无法自然承载这些信息。
更优雅的替代方案：使用 Bean Validation（Jakarta EE / Spring）
标准、简洁、可复用、支持国际化错误提示：
- 在 DTO 或请求对象字段上加注解：
@NotBlank(message = "用户名不能为空")、@Min(value = 18, message = "年龄不能小于18") - Controller 方法参数加
@Valid，框架自动校验并抛MethodArgumentNotValidException - 全局异常处理器统一捕获，提取
BindingResult中的FieldError，组装成 JSON 错误响应（含字段名、错误信息、错误码）
轻量级手动校验：用 Objects.requireNonNull + 自定义异常
若不用注解框架，推荐直接判空+抛定制异常，语义清晰、调试友好：
- 检查必填字段：
Objects.requireNonNull(username, "username 不能为空") - 检查业务约束：
if (age 150) throw new BusinessException("age", "年龄必须在 0~150 之间") - 封装一个工具方法：
Check.notNull(username, "用户名"); Check.inRange(age, 0, 150, "年龄")，内部统一抛出带字段名的ValidationException
如果坚持用 Optional（不推荐但需兼容旧代码）
仅限于“非空即合法”的极简场景，且必须补全错误上下文：
- 不要写：
Optional.ofNullable(name).orElseThrow()（没错误信息） - 应写：
Optional.ofNullable(name).orElseThrow(() -> new ValidationException("name", "用户名不可为空")) - 注意：此时
Optional只是语法糖，实际逻辑和if (name == null) throw ...完全等价，还多一层包装
