在Java中，IllegalArgumentException 是一个非检查异常（RuntimeException），用于表示向方法传递了一个不合法或不正确的参数。当程序检测到传入的参数不符合方法预期时，主动抛出该异常有助于提升代码的健壮性和可调试性。
参数值超出合理范围
当某个参数虽然类型正确，但其值不在允许范围内时，应抛出 IllegalArgumentException。
例如：- 要求传入年龄必须在 0 到 150 之间，若传入 -5 或 200，则抛出异常
- 分页查询中页码或每页数量为负数
- 数组索引、字符串位置等为负数或超过边界
这类场景适合用 IllegalArgumentException 明确指出“参数值”有问题，而不是用 IndexOutOfBoundsException 等更具体的异常（除非确实访问了数据结构）。
空值（null）作为不允许的参数
当方法明确要求某个参数不能为 null，而调用方传入了 null 时，可以抛出此异常。
立即学习“Java免费学习笔记（深入）”；
例如：- 自定义集合添加元素的方法：void add(String item)，如果 item 为 null 且不允许存空值
- 工具类方法处理字符串：public void process(String input)，input 不能为空
虽然 NullPointerException 也能被触发，但提前使用 IllegalArgumentException 主动校验并抛出，能提供更清晰的错误信息，便于排查问题。
参数格式或内容不符合要求
当参数需要满足特定格式或规则，但实际传入的数据不满足时。
例如：- 传入的字符串不是有效的邮箱格式或电话号码
- 枚举类型映射时，传入了不支持的字符串值
- 配置项中传入了非法的选项名称
此时可以在解析初期就进行校验，一旦发现非法输入立即抛出异常，避免后续处理出错。
状态依赖的参数校验失败
某些方法的行为依赖对象当前状态，传入的参数需与当前状态兼容。如果不兼容，也可视为非法参数。
例如：- 一个任务调度器不允许注册开始时间晚于结束时间的任务
- 文件处理器要求传入路径必须是绝对路径
这种情况下，即使参数本身合法，但在当前上下文中无效，也可以抛出 IllegalArgumentException 并附带说明原因。
基本上就这些。关键在于：只要参数“不合逻辑”、“不符合业务规则”或“无法继续处理”，就可以考虑抛出 IllegalArgumentException，并给出清晰的消息说明哪里错了。这比让程序默默出错或抛出模糊异常更有意义。
