IllegalArgumentException用于参数值逻辑错误时，如数值越界、null输入等；应在方法开头验证参数，提供明确错误消息，并可借助Objects或Guava等工具简化判断，提升API健壮性与可用性。
当方法接收到不合法或不合适的参数值时，Java中常用 IllegalArgumentException 来表明这一问题。正确处理这种异常不仅能提升代码的健壮性，还能让调用者快速定位问题。以下是实用的处理技巧和最佳实践。
何时抛出 IllegalArgumentException
这个异常适用于参数值在语法上正确，但逻辑上不符合要求的情况。比如传入负数作为数组长度、null 值作为非空参数等。
常见场景包括：- 参数为 null，而方法不允许
- 数值超出合理范围（如年龄为 -5）
- 字符串为空或仅空白字符，但需要有效内容
- 枚举值不在预期集合中
例如：
<font face="Courier New,Courier,monospace">public void setAge(int age) {
if (age < 0 || age > 150) {
throw new IllegalArgumentException("年龄必须在 0 到 150 之间");
}
this.age = age;
}</font>
提前验证参数
在方法执行核心逻辑前，先对所有参数进行校验。这样可以尽早发现问题，避免后续不必要的计算或状态变更。
立即学习“Java免费学习笔记（深入）”；
Google Blogger
下载
用于管理博客文章的 Blogger API 命令行工具，可发布、编辑、删除、列出和监控 Blogger 博客。适用于用户需要：(1) 在 Blogger 上发布博客文章...
- 使用 if 语句检查边界条件
- 对引用类型检查 null
- 利用工具类如 Objects.requireNonNull()
示例：
<font face="Courier New,Courier,monospace">public void setName(String name) {
if (name == null || name.trim().isEmpty()) {
throw new IllegalArgumentException("姓名不能为空");
}
this.name = name.trim();
}</font>
提供清晰的错误消息
抛出异常时附带具体信息，能极大提升调试效率。不要只写“非法参数”，要说明哪个参数有问题、为什么非法、期望值是什么。
推荐格式：- “参数 [name] 不能为 null”
- “count 必须大于 0，当前值: ” + count
- “不支持的状态值: '” + status + “’，允许值: STARTED, STOPPED”
结合断言或工具类简化判断
可使用 Java 自带或第三方库减少样板代码。
常用方式：- Objects.requireNonNull(obj, "obj 不能为 null")
- Apache Commons Lang 中的 Validate.isTrue(condition, message)
- Google Guava 的 Preconditions.checkArgument()
Guava 示例：
<font face="Courier New,Courier,monospace">import com.google.common.base.Preconditions;
public void process(int count) {
Preconditions.checkArgument(count > 0,
"数量必须大于 0，实际值: %s", count);
// 正常处理逻辑
}</font>
基本上就这些。关键是早验证、明提示、准定位。合理使用 IllegalArgumentException 能让你的 API 更易用也更可靠。
