Java中Illegal Argument Exception使用场景

在Java中,IllegalArgumentException 是一个非检查异常(RuntimeException),用于表示向方法传递了一个不合法或不正确的参数。当程序检测到传入的参数不符合方法预期时,主动抛出该异常有助于提升代码的健壮性和可调试性。

参数值超出合理范围

当某个参数虽然类型正确,但其值不在允许范围内时,应抛出 IllegalArgumentException。

例如:
  • 要求传入年龄必须在 0 到 150 之间,若传入 -5 或 200,则抛出异常
  • 分页查询中页码或每页数量为负数
  • 数组索引、字符串位置等为负数或超过边界

这类场景适合用 IllegalArgumentException 明确指出“参数值”有问题,而不是用 IndexOutOfBoundsException 等更具体的异常(除非确实访问了数据结构)。

空值(null)作为不允许的参数

当方法明确要求某个参数不能为 null,而调用方传入了 null 时,可以抛出此异常。

例如:
  • 自定义集合添加元素的方法:void add(String item),如果 item 为 null 且不允许存空值
  • 工具类方法处理字符串:public void process(String input),input 不能为空

虽然 NullPointerException 也能被触发,但提前使用 IllegalArgumentException 主动校验并抛出,能提供更清晰的错误信息,便于排查问题。

参数格式或内容不符合要求

当参数需要满足特定格式或规则,但实际传入的数据不满足时。

例如:
  • 传入的字符串不是有效的邮箱格式或电话号码
  • 枚举类型映射时,传入了不支持的字符串值
  • 配置项中传入了非法的选项名称

此时可以在解析初期就进行校验,一旦发现非法输入立即抛出异常,避免后续处理出错。

状态依赖的参数校验失败

某些方法的行为依赖对象当前状态,传入的参数需与当前状态兼容。如果不兼容,也可视为非法参数。

例如:
  • 一个任务调度器不允许注册开始时间晚于结束时间的任务
  • 文件处理器要求传入路径必须是绝对路径

这种情况下,即使参数本身合法,但在当前上下文中无效,也可以抛出 IllegalArgumentException 并附带说明原因。

基本上就这些。关键在于:只要参数“不合逻辑”、“不符合业务规则”或“无法继续处理”,就可以考虑抛出

IllegalArgumentException,并给出清晰的消息说明哪里错了。这比让程序默默出错或抛出模糊异常更有意义。