Java中IllegalArgumentException使用场景有哪些

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

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

1. 参数值超出允许范围

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

示例：

有道小P

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

64

查看详情

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

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

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

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

示例：

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

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

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

示例：

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

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

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

示例：

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

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