不能用 assert 做入参合法性检查，因其默认关闭、抛出不可捕获的 assertionerror，且框架不识别；应使用 objects.requirenonnull、illegalargumentexception 或 jakarta validation 注解进行显式运行时校验。
不能用 assert 做入参合法性检查。
assert 不是运行时校验工具
Java 的 assert 默认关闭，生产环境完全不执行；它抛出的是 AssertionError（继承自 Error），不是可捕获、可处理的 RuntimeException 子类。这意味着：
- 加了
assert userId > 0;，上线后等于没写； - 即使开启
-ea，失败也会直接终止线程，无法被try-catch拦截或统一处理； - 框架（如 Spring MVC）不识别
AssertionError，不会映射为 400 错误，容易导致客户端收到 500 或连接中断。
入参校验必须用显式异常
方法入口处对参数的合法性判断，应使用强制生效、语义明确的运行时校验方式：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
-
Objects.requireNonNull(obj, "obj must not be null")—— 非空检查最简洁安全； if (id —— 数值范围校验清晰可控；-
if (str == null || str.trim().isEmpty()) throw new IllegalArgumentException("name cannot be blank");—— 字符串非空非空白； - 配合 Jakarta Validation 注解（如
@NotBlank、@Min）在 DTO 层提前拦截，Service 层只做兜底校验。
assert 的合理位置：私有方法内部不变量检查
它适合用于开发阶段验证“本不该发生”的逻辑状态，且仅在启用 -ea 时起作用：
- 递归结束前，断言递归深度未超限；
- 排序算法执行后，断言数组首元素 ≤ 末元素；
- 缓存更新完成时，断言命中率 ≥ 预期下限（仅调试用，不影响线上性能）。
这类检查不是为了防用户输入，而是帮开发者快速发现代码逻辑漏洞。
别混淆工具职责
assert 是调试契约，IllegalArgumentException 是运行时契约。前者面向开发者，后者面向调用方。一个方法只要参数可能来自外部（哪怕只是另一个 public 方法传入），就必须用后者守门 —— 这不是啰嗦，是 API 可靠性的基本要求。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
