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

在Java开发中,IllegalArgumentException 是最常用的运行时异常之一,用于表明传入方法的参数不合法或不符合预期。合理使用它能提升代码健壮性和可维护性。关键不是简单抛出异常,而是清晰、及时地反馈问题所在。
何时使用 IllegalArgumentException
当方法接收到无法处理的参数值时,应主动验证并抛出 IllegalArgumentException。常见场景包括:
- 参数为 null,但方法不允许
- 数值超出合理范围(如年龄为负数)
- 字符串为空或格式错误
- 枚举值不在允许集合内
不要等到后续逻辑出错才暴露问题,应在方法入口尽早校验。
推荐的参数验证方式
直接使用 if 判断配合手动抛出异常是最清晰的方式,尤其适合简单场景。
立即学习“Java免费学习笔记(深入)”;
示例:
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")
包含实际值、期望范围和参数名,能让调用者立刻明白哪里出错。
基本上就这些。关键是早验证、明提示、少重复。别让调用方猜问题出在哪。










