17370845950

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

在Java开发中，IllegalArgumentException 是一个非常常见的运行时异常，用于表示向方法传递了一个不合法或不正确的参数。它继承自 RuntimeException，因此属于非检查异常（unchecked exception），不需要强制捕获或声明。

何时抛出 IllegalArgumentException

当方法接收到的参数虽然类型正确，但其值不符合业务逻辑或约束条件时，应主动抛出该异常。常见场景包括：

• 参数为空（null）且不允许为空
• 数值参数超出合理范围（如负数作为数组索引）
• 字符串参数格式错误或为空字符串
• 枚举值不在允许范围内

典型使用示例

以下是一些典型的使用方式：

if (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 或借助工具类提升效率。

例如，使用 Objects.requireNonNull() 简化 null 判断：

Objects.requireNonNull(obj, "对象不能为空");
这行代码等价于手动判断 null 并抛出异常，更加简洁。

Apache Commons Lang 中的 Validate 类也提供了丰富的校验方法，比如：

Validate.isTrue(age >= 0, "年龄不能为负数");

基本上就这些。合理使用 IllegalArgumentException 能让代码更健壮，帮助调用者快速发现传参问题，是一种良好的编程习惯。关键是提供清晰、具体的错误信息，便于调试。