IllegalArgumentException用于参数不合法时抛出，如数值越界、空值等；应在方法入口校验参数并提供明确错误信息，结合Objects工具类简化判断，必要时捕获异常处理用户输入，提升代码健壮性。
在Java开发中，IllegalArgumentException 是一个常见的运行时异常（RuntimeException），用于表示向方法传递了一个不合法或不正确的参数。它属于程序逻辑错误的一种提示，合理使用和捕获该异常有助于提升代码的健壮性和可读性。
何时抛出 IllegalArgumentException
当方法接收到不符合预期的参数值时，应主动抛出 IllegalArgumentException。比如数值超出范围、字符串为空或格式错误、对象引用为 null 但不允许等。
常见场景包括：
- 传入的索引为负数或超过数组长度
- 期望非空字符串却传入 null 或空串
- 数值参数不在有效范围内（如年龄不能为负）
- 枚举类型参数不匹配预定义值
示例：
立即学习“Java免费学习笔记（深入）”；
public void setAge(int age) {
if (age < 0 || age > 150) {
throw new IllegalArgumentException("年龄必须在0到150之间");
}
this.age = age;
}
如何捕获和处理该异常
虽然 IllegalArgumentException 是运行时异常，通常不需要强制捕获，但在某些场景下进行捕获可以更好地控制流程或记录日志。
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
例如，在解析用户输入或外部数据时，可以使用 try-catch 进行兜底处理：
try {
processUserInput(userInput);
} catch (IllegalArgumentException e) {
System.err.println("参数错误：" + e.getMessage());
// 可记录日志、返回默认值或通知调用方
}
注意：不要过度捕获此类异常。它更多是用于“提前暴露问题”，而不是常规流程控制。
最佳实践建议
合理使用 IllegalArgumentException 能让代码更清晰、更容易维护。
- 在方法入口处校验关键参数，及时抛出异常
- 提供清晰、具体的错误信息，便于调试
- 结合断言或工具类（如 Objects.requireNonNull）简化判断
- 在公共API中明确文档化可能抛出的该异常
例如使用 Objects 工具类：
public void setName(String name) {
Objects.requireNonNull(name, "名称不能为null");
if (name.trim().isEmpty()) {
throw new IllegalArgumentException("名称不能为空字符串");
}
this.name = name.trim();
}
基本上就这些。正确使用 IllegalArgumentException，能让调用者快速定位参数问题，提高开发效率和系统稳定性。
