IllegalArgumentException用于参数校验失败时抛出,常见于null值、数值越界、字符串无效等场景,推荐使用Objects.requireNonNull或Apache Validate工具类简化校验,提升代码健壮性。

在Java开发中,IllegalArgumentException 是一个非常常见的运行时异常,用于表示向方法传递了一个不合法或不正确的参数。它继承自 RuntimeException,因此属于非检查异常(unchecked exception),不需要强制捕获或声明。
何时抛出 IllegalArgumentException
当方法接收到的参数虽然类型正确,但其值不符合业务逻辑或约束条件时,应主动抛出该异常。常见场景包括:
- 参数为空(null)且不允许为空
- 数值参数超出合理范围(如负数作为数组索引)
- 字符串参数格式错误或为空字符串
- 枚举值不在允许范围内
典型使用示例
以下是一些典型的使用方式:
// 检查对象是否为 nullif (obj == null) {
throw new IllegalArgumentException("对象不能为 null");
}
if (age 150) {
throw new IllegalArgumentException("年龄必须在 0 到 150 之间");
}
if (str == null || str.trim().isEmpty()) {
throw new IllegalArgumentException("字符串不能为空");
}
与断言和第三方库的对比
虽然可以使用 assert 进行参数校验,但 assert 默认是关闭的,不适合用于生产环境的参数验证。更推荐直接使用 IllegalArgumentException 或借助工具类提升效率。
立即学习“Java免费学习笔记(深入)”;
BIWEB 门户版几经周折,最终与大家见面了。BIWEB门户版建立在ArthurXF5.8.3底层上,有了更加强大的功能。 BIWEB WMS v5.8.3 (2010.1.29) 更新功能如下: 1.修正了底层getInfo方法中的调用参数,做到可以根据字段进行调用。 2.修正了栏目安装和卸载后,跳转链接的错误。 3.修正所有栏目分类系统,提交信息页面错误。 4.新增后台删除信息后仍停留原分
例如,使用 Objects.requireNonNull() 简化 null 判断:
Objects.requireNonNull(obj, "对象不能为空");
这行代码等价于手动判断 null 并抛出异常,更加简洁。
Apache Commons Lang 中的 Validate 类也提供了丰富的校验方法,比如:
Validate.isTrue(age >= 0, "年龄不能为负数");
基本上就这些。合理使用 IllegalArgumentException 能让代码更健壮,帮助调用者快速发现传参问题,是一种良好的编程习惯。关键是提供清晰、具体的错误信息,便于调试。









