IllegalArgumentException用于参数校验，当传入值不符合逻辑时抛出，如数值越界、字符串为空、集合为空等；可通过Objects.requireNonNull简化非空判断，封装通用校验方法提升复用性，并应提供明确错误信息以增强接口健壮性和可维护性。
在Java开发中，IllegalArgumentException 是处理方法参数非法或不合规时最常用的异常之一。它属于运行时异常（RuntimeException），用于表明传入方法的参数虽然类型正确，但其值不符合预期逻辑。合理使用该异常能提升代码健壮性和可维护性。
何时抛出 IllegalArgumentException
当方法接收到语义上无效的参数时，应主动检查并抛出 IllegalArgumentException。常见场景包括：
- 数值参数超出合理范围（如年龄为负数）
- 字符串参数为空或空白（null 或 "" 或 " "）
- 集合参数为空但不允许
- 枚举值不在允许
范围内
- 对象状态不满足调用前提
例如：
public void setAge(int age) {
if (age < 0 || age > 150) {
throw new IllegalArgumentException("年龄必须在 0 到 150 之间");
}
this.age = age;
}
结合 Objects.requireNonNull 验证非空
Java 7 引入了 Objects.requireNonNull() 方法，是验证参数是否为 null 的简洁方式。若参数为 null，自动抛出 IllegalArgumentException（可自定义消息）。
import java.util.Objects;
public void setName(String name) {
this.name = Objects.requireNonNull(name, "姓名不能为空");
}
此方法不仅代码简洁，还能清晰表达约束条件。
封装校验逻辑提升复用性
对于频繁使用的校验规则，建议封装成工具方法，避免重复代码。
public class Validate {
public static void notNull(Object obj, String message) {
if (obj == null) throw new IllegalArgumentException(message);
}
public static void notEmpty(String str, String message) {
if (str == null || str.trim().isEmpty()) {
throw new IllegalArgumentException(message);
}
}
public static void inRange(int value, int min, int max, String message) {
if (value < min || value > max) {
throw new IllegalArgumentException(message);
}
}
}
使用示例：
public void registerUser(String email, int age) {
Validate.notEmpty(email, "邮箱不能为空");
Validate.inRange(age, 18, 120, "用户年龄必须在18到120之间");
// 继续业务逻辑
}
提供清晰的异常信息
抛出异常时，附带具体、可读性强的错误消息，有助于调试和日志分析。
- 避免使用“参数错误”这类模糊描述
- 说明期望值与实际值（如果安全）
- 提示合法取值范围
例如：
throw new IllegalArgumentException(
String.format("文件类型 '%s' 不支持，仅支持 %s", type, SUPPORTED_TYPES));
基本上就这些。合理使用 IllegalArgumentException 能让调用方快速定位问题，同时增强接口契约的明确性。关键在于尽早验证、清晰反馈、避免隐藏错误。
