Java中IllegalArgumentException使用场景有哪些-java教程-PHP中文网

Java中IllegalArgumentException使用场景有哪些

P粉602998670

发布： 2025-10-11 14:14:01

原创

612人浏览过

IllegalArgumentException用于参数非法时抛出，典型场景包括：1. 参数值超出范围，如年龄不在0-150；2. 允许null但参数为null，如姓名不能为空；3. 字符串格式错误，如手机号非11位数字；4. 枚举或状态值不在预定义集合中，如订单状态无效。

java中illegalargumentexception使用场景有哪些

IllegalArgumentException 是 Java 中一个常见的运行时异常，用于表示向方法传递了一个不合法或不正确的参数。当参数的值不符合方法期望的条件时，抛出该异常是合理且推荐的做法。以下是 IllegalArgumentException 的典型使用场景。

1. 参数值超出允许范围

当传入的参数虽然类型正确，但其数值不在有效范围内时，应抛出 IllegalArgumentException。

例如，方法要求传入年龄必须在 0 到 150 之间，若传入 -5 或 200，则应拒绝并抛出异常。
类似地，索引类操作中，负数索引或超过数组长度的索引也属于此类情况。

示例：

有道小P

有道小P，新一代AI全科学习助手，在学习中遇到任何问题都可以问我。

查看详情

if (age < 0 || age > 150) {<br/>
    throw new IllegalArgumentException("年龄必须在0到150之间");<br/>
}

登录后复制

2. 参数为 null 且不允许为空

某些方法明确要求传入的参数不能为 null。尽管有时会使用 NullPointerException，但使用 IllegalArgumentException 更能准确表达“参数非法”的语义。

立即学习“Java免费学习笔记（深入）”；

比如，一个处理用户姓名的方法不允许 name 为 null。
此时抛出 IllegalArgumentException 并附带说明更清晰。

示例：

if (name == null) {<br/>
    throw new IllegalArgumentException("姓名不能为null");<br/>
}

登录后复制

3. 字符串参数格式不合法

当方法期望特定格式的字符串（如邮箱、电话号码、日期等），而输入不符合规定格式时，可抛出此异常。

例如，解析手机号的方法要求输入为 11 位数字，若传入非数字或长度不对，则视为非法参数。

示例：

if (!phone.matches("\d{11}")) {<br/>
    throw new IllegalArgumentException("手机号必须为11位数字");<br/>
}

登录后复制

4. 枚举或状态值不在预期集合中

当传入的参数应属于某个预定义集合（如枚举值、状态码）但实际不在其中时，说明参数无效。

例如，订单状态只接受 "PENDING", "SHIPPED", "DELIVERED"，若传入 "UNKNOWN"，则应抛出异常。

示例：

Set<String> validStatuses = Set.of("PENDING", "SHIPPED", "DELIVERED");<br/>
if (!validStatuses.contains(status)) {<br/>
    throw new IllegalArgumentException("非法订单状态: " + status);<br/>
}

登录后复制

基本上就这些。合理使用 IllegalArgumentException 能让 API 更健壮，帮助调用者快速发现并修正错误。关键是提供清晰的错误信息，说明什么参数出了问题以及合法范围是什么。

以上就是Java中IllegalArgumentException使用场景有哪些的详细内容，更多请关注php中文网其它相关文章！

大家都在看：

在Java中如何使用Exception链记录异常信息_异常链处理实践经验 Java While 循环教程：实现数字范围顺序打印 Java内存模型中“正确同步”概念在组件级别应用的可能性与实践里氏替换原则在Java中如何实现 Java中动态加载类：理解Class.forName与全限定类名解析策略