17370845950

IllegalArgumentException应在参数不合法时尽早抛出，如null值、数值越界、字符串格式错误等；推荐使用if判断或Objects.requireNonNull进行校验，并可通过自定义Validate工具类统一处理，提升代码可维护性。

在Java开发中，IllegalArgumentException 是最常用的运行时异常之一，用于表明传入方法的参数不合法或不符合预期。合理使用它能提升代码健壮性和可维护性。关键不是简单抛出异常，而是清晰、及时地反馈问题所在。

何时使用 IllegalArgumentException

当方法接收到无法处理的参数值时，应主动验证并抛出 IllegalArgumentException。常见场景包括：

• 参数为 null，但方法不允许
• 数值超出合理范围（如年龄为负数）
• 字符串为空或格式错误
• 枚举值不在允许集合内

不要等到后续逻辑出错才暴露问题，应在方法入口尽早校验。

推荐的参数验证方式

直接使用 if 判断配合手动抛出异常是最清晰的方式，尤其适合简单场景。

public void setAge(int age) {
    if (age < 0 || age > 150) {
        throw new IllegalArgumentException("年龄必须在 0 到 150 之间，实际值: " + age);
    }
    this.age = age;
}

对于 null 检查，可以结合 Objects.requireNonNull：

public void setName(String name) {
    Objects.requireNonNull(name, "姓名不能为 null");
    if (name.trim().isEmpty()) {
        throw new IllegalArgumentException("姓名不能为空字符串");
    }
    this.name = name.trim();
}

使用断言或工具类统一处理

在大型项目中，可封装参数校验逻辑，避免重复代码。例如自定义 Validate 工具类：

public class Validate {
    public static void isTrue(boolean expression, String message) {
        if (!expression) {
            throw new IllegalArgumentException(message);
        }
    }

    public static  T notNull(T object, String message) {
        if (object == null) {
            throw new IllegalArgumentException(message);
        }
        return object;
    }
}

使用后代码更简洁：

public void processUser(User user, int level) {
    Validate.notNull(user, "用户对象不能为空");
    Validate.isTrue(level >= 1 && level <= 10, "等级必须在 1-10 范围内");
    // 正常逻辑
}

异常信息要具体有用

抛出异常时，提供明确的上下文信息，有助于快速定位问题。

• 差：throw new IllegalArgumentException("参数无效")
• 好：throw new IllegalArgumentException("文件大小不能超过 10MB，当前值: " + size + "MB")

包含实际值、期望范围和参数名，能让调用者立刻明白哪里出错。

基本上就这些。关键是早验证、明提示、少重复。别让调用方猜问题出在哪。