IllegalArgumentException 由方法内部抛出,不该捕获——它标识调用方传入非法参数的逻辑错误;应尽早校验并明确提示非法值与合法范围,优先使用 Objects.requireNonNull 或 Guava Preconditions 简化断言。

IllegalArgumentException 是谁抛的,该不该捕获
它继承自 RuntimeException,属于 unchecked 异常,编译器不强制你 try-catch 或声明 throws。绝大多数情况下,你不该捕获它——因为它代表**调用方传入了非法参数**,是逻辑错误,不是运行时意外(比如网络超时、文件不存在)。捕获后吞掉或泛化处理,反而掩盖了 bug 的真实位置。
真正该做的是:在方法入口快速失败,用 IllegalArgumentException 明确指出错在哪。比如:
public void setAge(int age) {
if (age < 0 || age > 150) {
throw new IllegalArgumentException("age must be between 0 and 150, but got: " + age);
}
this.age = age;
}
- 检查时机越早越好,别等计算到一半才报错
- 消息里必须包含非法值(如
age的实际值)和合法范围,方便调试 - 避免只写 "Invalid argument" 这类空洞描述
用 Objects.requireNonNull 和 Guava 的 Preconditions 简化校验
手写 if (x == null) + throw 太啰嗦,且容易漏消息拼接。JDK 自带的 Objects.requireNonNull 能省力又清晰:
public void process(String name, List- items) { Objects.requireNonNull(name, "name must not be null"); Objects.requireNonNull(items, "items must not be null"); // ... }
Guava 的 Preconditions 更进一步,支持数值范围、集合非空、字符串非空白等常用断言:
立即学习“Java免费学习笔记(深入)”;
用 php + mysql 驱动的在线商城系统,我们的目标为中国的中小企业及个人提供最简洁,最安全,最高效的在线商城解决方案,使用了自建的会员积分折扣功能,不同的会员组有不同的折扣,让您的商店吸引更多的后续客户。 系统自动加分处理功能,自动处理会员等级,免去人工处理的工作量,让您的商店运作起来更方便省事 采用了自建的直接模板技术,免去了模板解析时间,提高了代码利用效率 独立开发的购物车系统,使用最
import static com.google.common.base.Preconditions.*; // ... checkArgument(age >= 0 && age <= 150, "age out of range: %s", age); checkNotNull(name, "name cannot be null"); checkState(!items.isEmpty(), "items list is empty");
-
checkArgument对应参数合法性(即IllegalArgumentException场景) -
checkState用于对象内部状态非法(抛IllegalStateException) - 所有方法都支持格式化消息,避免字符串拼接开销
构造函数里抛 IllegalArgumentException 的特殊注意事项
构造函数是对象生命周期起点,这里抛 IllegalArgumentException 尤其关键——它意味着对象根本没创建成功。但要注意两个易错点:
- 不要在构造函数里调用可被子类重写的方法(
this.xxx()),否则可能触发未初始化对象上的逻辑,导致 NPE 或更隐蔽错误 - 如果构造参数需转换(如
String转LocalDate),解析失败时别直接抛DateTimeParseException,而应包装为IllegalArgumentException,保持异常语义统一 - 避免在构造函数里做耗时操作(如远程校验、文件读取),这会让异常抛出变得不可预测,也违背“构造即验证”原则
单元测试里必须覆盖 IllegalArgumentException 场景
既然你主动抛这个异常,就得证明它在非法输入下真能触发。JUnit 5 推荐用 assertThrows 显式断言:
@Test
void shouldThrowIAEWhenAgeIsNegative() {
IllegalArgumentException ex = assertThrows(
IllegalArgumentException.class,
() -> new Person(-5)
);
assertTrue(ex.getMessage().contains("age"));
}
注意别只测 null,还要覆盖边界值、负数、超大数、非法字符串等典型非法输入。Mockito 等框架无法帮你测这类底层校验,必须靠真实调用。
最常被忽略的是:当多个参数同时非法时,只抛第一个检查的异常,后续校验不会执行。所以参数检查顺序要有逻辑——先判 null,再判空集合,最后判业务规则,这样错误信息才最贴近用户意图。









