0

0

Java中的IllegalArgumentException的处理技巧

P粉602998670

P粉602998670

发布时间:2026-01-11 16:54:57

|

245人浏览过

|

来源于php中文网

原创

IllegalArgumentException 由方法内部抛出,不该捕获——它标识调用方传入非法参数的逻辑错误;应尽早校验并明确提示非法值与合法范围,优先使用 Objects.requireNonNull 或 Guava Preconditions 简化断言。

java中的illegalargumentexception的处理技巧

IllegalArgumentException 是谁抛的,该不该捕获

它继承自 RuntimeException,属于 unchecked 异常,编译器不强制你 try-catch 或声明 throws。绝大多数情况下,你不该捕获它——因为它代表**调用方传入了非法参数**,是逻辑错误,不是运行时意外(比如网络超时、文件不存在)。捕获后吞掉或泛化处理,反而掩盖了 bug 的真实位置。

真正该做的是:在方法入口快速失败,用 IllegalArgumentException 明确指出错在哪。比如:

public void setAge(int age) {
    if (age < 0 || age > 150) {
        throw new IllegalArgumentException("age must be between 0 and 150, but got: " + age);
    }
    this.age = age;
}
  • 检查时机越早越好,别等计算到一半才报错
  • 消息里必须包含非法值(如 age 的实际值)和合法范围,方便调试
  • 避免只写 "Invalid argument" 这类空洞描述

用 Objects.requireNonNull 和 Guava 的 Preconditions 简化校验

手写 if (x == null) + throw 太啰嗦,且容易漏消息拼接。JDK 自带的 Objects.requireNonNull 能省力又清晰:

public void process(String name, List items) {
    Objects.requireNonNull(name, "name must not be null");
    Objects.requireNonNull(items, "items must not be null");
    // ...
}

Guava 的 Preconditions 更进一步,支持数值范围、集合非空、字符串非空白等常用断言:

立即学习Java免费学习笔记(深入)”;

ShoopD 网上商店系统
ShoopD 网上商店系统

用 php + mysql 驱动的在线商城系统,我们的目标为中国的中小企业及个人提供最简洁,最安全,最高效的在线商城解决方案,使用了自建的会员积分折扣功能,不同的会员组有不同的折扣,让您的商店吸引更多的后续客户。 系统自动加分处理功能,自动处理会员等级,免去人工处理的工作量,让您的商店运作起来更方便省事 采用了自建的直接模板技术,免去了模板解析时间,提高了代码利用效率 独立开发的购物车系统,使用最

下载
import static com.google.common.base.Preconditions.*;
// ...
checkArgument(age >= 0 && age <= 150, "age out of range: %s", age);
checkNotNull(name, "name cannot be null");
checkState(!items.isEmpty(), "items list is empty");
  • checkArgument 对应参数合法性(即 IllegalArgumentException 场景)
  • checkState 用于对象内部状态非法(抛 IllegalStateException
  • 所有方法都支持格式化消息,避免字符串拼接开销

构造函数里抛 IllegalArgumentException 的特殊注意事项

构造函数是对象生命周期起点,这里抛 IllegalArgumentException 尤其关键——它意味着对象根本没创建成功。但要注意两个易错点:

  • 不要在构造函数里调用可被子类重写的方法(this.xxx()),否则可能触发未初始化对象上的逻辑,导致 NPE 或更隐蔽错误
  • 如果构造参数需转换(如 StringLocalDate),解析失败时别直接抛 DateTimeParseException,而应包装为 IllegalArgumentException,保持异常语义统一
  • 避免在构造函数里做耗时操作(如远程校验、文件读取),这会让异常抛出变得不可预测,也违背“构造即验证”原则

单元测试里必须覆盖 IllegalArgumentException 场景

既然你主动抛这个异常,就得证明它在非法输入下真能触发。JUnit 5 推荐用 assertThrows 显式断言:

@Test
void shouldThrowIAEWhenAgeIsNegative() {
    IllegalArgumentException ex = assertThrows(
        IllegalArgumentException.class,
        () -> new Person(-5)
    );
    assertTrue(ex.getMessage().contains("age"));
}

注意别只测 null,还要覆盖边界值、负数、超大数、非法字符串等典型非法输入。Mockito 等框架无法帮你测这类底层校验,必须靠真实调用。

最常被忽略的是:当多个参数同时非法时,只抛第一个检查的异常,后续校验不会执行。所以参数检查顺序要有逻辑——先判 null,再判空集合,最后判业务规则,这样错误信息才最贴近用户意图。

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

831

2023.06.15

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

737

2023.07.05

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

733

2023.07.31

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

396

2023.08.01

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

398

2023.08.02

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

446

2023.08.02

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

430

2023.08.02

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

16925

2023.08.03

c++主流开发框架汇总
c++主流开发框架汇总

本专题整合了c++开发框架推荐,阅读专题下面的文章了解更多详细内容。

80

2026.01.09

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Kotlin 教程
Kotlin 教程

共23课时 | 2.4万人学习

C# 教程
C# 教程

共94课时 | 6.5万人学习

Java 教程
Java 教程

共578课时 | 44.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号