Java参数校验技巧：捕获IllegalArgumentException

在Java开发中，IllegalArgumentException是参数校验的核心利器，用于及时拦截null值、越界数值、非法格式等不合规输入；文章深入解析了其规范抛出场景、灵活捕获策略（从局部try-catch到Spring Boot全局@ControllerAdvice统一处理）、以及借助Objects.requireNonNull等工具类简化校验逻辑的实用技巧，强调通过清晰异常信息、入口层前置校验和与声明式注解协同，实现早发现、早反馈的健壮防御体系——掌握这些技巧，能让代码更可靠、错误更透明、维护更高效。

在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

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

使用 try-catch 捕获示例：

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();
}

最佳实践建议

合理使用 IllegalArgumentException 能让代码更清晰，但需注意以下几点：

• 异常信息应具体明确，便于排查问题
• 优先在入口方法（如控制器、公共API）做参数校验
• 避免在私有方法中过度校验，根据上下文决定是否需要
• 结合注解校验（如 Jakarta Bean Validation）实现声明式校验

基本上就这些。掌握抛出与捕获 IllegalArgumentException 的技巧，能让参数校验更有条理，异常处理更优雅。关键是早发现、早反馈，把问题控制在源头。

本篇关于《Java参数校验技巧：捕获IllegalArgumentException》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！