登录
首页 >  文章 >  java教程

Java参数校验抛出IllegalArgException方法详解

时间：2026-03-22 10:31:32 360浏览 收藏

本文深入讲解了Java中如何通过抛出`IllegalArgumentException`进行高效、规范的参数校验，涵盖null检查、数值范围验证、字符串与集合合法性判断等核心场景，并重点推荐使用`Objects.requireNonNull`简化代码、提升可读性与健壮性；强调主动抛出带有明确业务语义的异常信息，不仅能快速暴露调用方传参错误，还能让方法契约更清晰、问题定位更精准——掌握这些实践技巧，让你的Java代码更可靠、更易维护。

在Java中如何抛出IllegalArgumentException来校验参数

在Java中，IllegalArgumentException 是一个非受检异常（unchecked exception），常用于方法参数校验时抛出，表示传入的参数不合法或不符合预期。通过主动抛出这个异常，可以提高代码的健壮性和可读性。

何时使用 IllegalArgumentException

当方法接收到不符合业务逻辑或约束条件的参数时，应立即中断执行并提示调用方问题所在。例如：

  • 参数为 null，但不允许为空
  • 数值超出合理范围（如年龄为负数）
  • 字符串为空或格式错误
  • 集合为空但要求非空

如何手动抛出 IllegalArgumentException

可以直接使用 throw new IllegalArgumentException("错误信息") 来抛出异常，并附带清晰的描述信息。

public void setAge(int age) {
    if (age  150) {
        throw new IllegalArgumentException("年龄必须在0到150之间，实际值：" + age);
    }
    this.age = age;
}

常见的参数校验场景与写法

以下是一些典型校验示例：

// 校验对象非null
public void processUser(User user) {
    if (user == null) {
        throw new IllegalArgumentException("用户对象不能为null");
    }
    // 处理逻辑
}

// 校验字符串非空
public void setName(String name) {
    if (name == null || name.trim().isEmpty()) {
        throw new IllegalArgumentException("姓名不能为空");
    }
    this.name = name.trim();
}

// 校验集合非空
public void addScores(List<integer> scores) {
    if (scores == null || scores.isEmpty()) {
        throw new IllegalArgumentException("成绩列表不能为空");
    }
    this.scores.addAll(scores);
}
</integer>

使用 Objects.requireNonNull 简化 null 校验

Java 7+ 提供了 Objects.requireNonNull 方法，可用于简化 null 判断。

import java.util.Objects;

public void setEmail(String email) {
    Objects.requireNonNull(email, "邮箱地址不能为null");
    if (!email.contains("@")) {
        throw new IllegalArgumentException("邮箱格式不正确: " + email);
    }
    this.email = email;
}

基本上就这些。合理使用 IllegalArgumentException 能让方法契约更清晰，帮助调用者快速发现和修复问题。关键是提供有意义的错误消息，说明“哪里错了”以及“期望是什么”。

理论要掌握，实操不能落！以上关于《Java参数校验抛出IllegalArgException方法详解》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！

资料下载
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>