在Java中如何捕获IllegalArgumentException进行参数校验_参数异常处理技巧-java教程-PHP中文网

在Java中如何捕获IllegalArgumentException进行参数校验_参数异常处理技巧

P粉602998670

发布： 2025-10-29 22:55:02

原创

468人浏览过

IllegalArgumentException用于参数校验，当传入非法参数时抛出，如null值、越界数值等；可通过try-catch局部捕获或@ControllerAdvice全局处理；结合Objects.requireNonNull等工具简化校验，提升代码健壮性与可维护性。

在java中如何捕获illegalargumentexception进行参数校验_参数异常处理技巧

在Java开发中，IllegalArgumentException 是一个常用的运行时异常，通常用于表示传入方法的参数不合法或不符合预期。合理地捕获和处理这个异常，能有效提升代码的健壮性和可维护性。虽然它属于非受检异常（unchecked exception），不需要强制捕获，但在某些场景下进行捕获并统一处理，是参数校验与异常管理的重要技巧。

何时抛出 IllegalArgumentException

当方法接收到非法、无效或不合理的参数值时，应主动抛出 IllegalArgumentException。常见情况包括：

参数为 null，但不允许为空
数值超出合理范围（如年龄为负数）
字符串格式不符合要求（如邮箱格式错误）
枚举值不在允许范围内

示例：

public void setAge(int age) {
    if (age < 0 || age > 150) {
        throw new IllegalArgumentException("年龄必须在0到150之间");
    }
    this.age = age;
}

登录后复制

如何捕获 IllegalArgumentException

尽管可以在方法内部直接抛出该异常，但在调用层或统一异常处理机制中进行捕获，有助于集中处理错误信息，避免程序崩溃。

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

使用 try-catch 捕获示例：

即构数智人

即构数智人是由即构科技推出的AI虚拟数字人视频创作平台，支持数字人形象定制、短视频创作、数字人直播等。

查看详情

try {
    userService.setAge(-5);
} catch (IllegalArgumentException e) {
    System.err.println("参数错误：" + e.getMessage());
    // 可记录日志、返回友好提示等
}

登录后复制

在 Web 应用中（如 Spring Boot），更推荐使用全局异常处理器：

@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(IllegalArgumentException.class)
    public ResponseEntity<String> handleIllegalArgument(IllegalArgumentException e) {
        return ResponseEntity.badRequest().body("参数不合法：" + e.getMessage());
    }
}

登录后复制

结合断言与工具类简化校验

手动编写 if 判断容易冗余，可借助 JDK 自带方法或第三方工具提升效率。

Objects.requireNonNull()：检查是否为 null
StringUtils（Apache Commons Lang）：判断字符串是否为空
自定义校验工具类封装常用逻辑

示例：

public void setName(String name) {
    Objects.requireNonNull(name, "姓名不能为空");
    if (name.trim().isEmpty()) {
        throw new IllegalArgumentException("姓名不能全为空格");
    }
    this.name = name.trim();
}

登录后复制