Java中的IllegalArgumentException怎么用_方法参数校验与防御性编程实战-java教程-PHP中文网

illegalargumentexception应在方法入口立即识别出调用方传入明显不合逻辑的参数时抛出，如负数数量、null非空引用、空字符串等；应避免替代nullpointerexception、深层计算后抛出或混杂业务逻辑。

java中的illegalargumentexception怎么用_方法参数校验与防御性编程实战

什么时候该抛`IllegalArgumentException`

它不是用来兜底所有参数错误的，而是专治「调用方传了明显不合逻辑的值，且这个错误在方法入口就能立刻识别」的情况。比如传了负数给表示数量的参数、null给不允许为空的引用类型、空字符串给要求非空的name字段。

常见错误现象：
– 用IllegalArgumentException代替NullPointerException（后者更语义准确，且JVM对Objects.requireNonNull有优化）
– 在方法内部深层计算后才抛出（这时应考虑业务异常，而非非法参数）
– 校验逻辑和业务逻辑混在一起，导致方法职责模糊

只在校验失败能**立刻归因到调用方输入**时抛出
优先用Objects.requireNonNull校验null，它抛的是NullPointerException，但语义更清晰、堆栈更干净
字符串非空校验推荐Objects.requireNonNull(str, "str must not be null")或StringUtils.isNotBlank(str)（Apache Commons），别手写str == null || str.trim().isEmpty()

`IllegalArgumentException`的构造函数怎么选

核心就两条：消息要具体，别只写“参数错误”；避免拼接敏感信息（如密码、token）进异常消息。JDK 提供了三个常用重载：

new IllegalArgumentException(String message)：最常用，适合简单说明，例如new IllegalArgumentException("timeoutMs must be > 0, got: " + timeoutMs)
new IllegalArgumentException(String message, Throwable cause)：极少用——它本意是包装底层异常，但IllegalArgumentException本身不表示链式故障，强行套用反而干扰问题定位
new IllegalArgumentException(Throwable cause)：基本不用，消息全丢掉了，等于自废诊断能力

注意：message里别直接拼接用户输入，尤其涉及日志采集时可能泄露数据；数值类校验建议用String.format或Integer.toString显式转换，避免隐式toString()触发意外行为。

java-enterprise

Java企业开发专家，专注于Spring Boot、微服务架构和JVM优化。适用于：Java语言掌握、

下载

和`Assert`、`@NonNull`这些工具什么关系

它们目标相似，但生效时机和约束力完全不同：断言（assert）默认关闭，仅用于开发阶段快速失败；@NonNull是静态检查注解（如JetBrains或Checker Framework），不产生运行时校验；而IllegalArgumentException是实打实的运行时防御，生产环境必须起效。

别依赖assert做关键参数校验——上线后-ea没开，校验就消失了
@NonNull配合IDE或编译插件能提前报错，但无法替代运行时校验（比如反射调用、动态代理场景）
Spring 的@Valid或 Hibernate Validator 是另一层校验，走AOP或注解处理器，和手写IllegalArgumentException不冲突，但别重复校验同一字段

真实项目里，三者常共存：开发期靠@NonNull提示、测试期靠assert捕获低级错误、生产期靠IllegalArgumentException兜底。

性能影响和 JIT 优化要注意什么

抛异常本身开销大，但IllegalArgumentException的构造成本主要在填充堆栈（fillInStackTrace）。现代JVM（如HotSpot）会对频繁抛出的异常做「stack trace suppression」优化，前提是异常类型固定、消息模板固定、且方法被充分JIT编译。