在Java中如何捕获并处理IllegalArgumentException

IllegalArgumentException属于Java运行时异常体系，继承自RuntimeException，当方法被传入不符合要求的参数时就会被抛出，比如传入负数给要求正数的方法，或者传入格式错误的字符串给解析方法。这类异常不需要在方法声明中显式抛出，但是如果不处理会导致程序直接终止，因此掌握它的捕获和处理方法很有必要。

IllegalArgumentException的常见触发场景

日常开发中很多操作都可能触发这个异常，常见的场景有以下几种：

• 调用方法时传入超出允许范围的参数，比如给要求1到100的方法传入-5
• 传入格式不符合要求的字符串，比如用Integer.parseInt解析包含字母的字符串
• 传入空值给不允许为空的方法参数，部分方法会主动校验并抛出该异常
• 枚举值转换时传入不存在的枚举名称，也可能触发该异常

使用try-catch捕获处理IllegalArgumentException

捕获IllegalArgumentException的方式和其他异常类似，使用try-catch代码块即可，在try中编写可能抛出异常的代码，在catch中处理异常逻辑。

基础捕获示例

下面是一个简单的示例，演示捕获解析字符串时的IllegalArgumentException：

public class IllegalArgumentExceptionDemo {
    public static void main(String[] args) {
        String numStr = "12a3";
        try {
            // 尝试将字符串转换为整数，格式错误会抛出IllegalArgumentException
            int num = Integer.parseInt(numStr);
            System.out.println("转换后的数字是：" + num);
        } catch (IllegalArgumentException e) {
            // 捕获异常后打印提示信息，也可以做其他处理逻辑
            System.out.println("参数格式不合法，无法转换为整数：" + e.getMessage());
            // 可以记录异常日志，方便后续排查问题
            // log.error("参数转换失败", e);
        }
    }
}

自定义异常提示的处理方式

如果是自己编写的方法需要校验参数并抛出IllegalArgumentException，可以在抛出异常时附带更明确的提示信息，方便调用方处理：

public class ParamCheckDemo {
    // 计算平方的方法，要求参数必须大于0
    public static int square(int num) {
        if (num <= 0) {
            // 抛出带明确提示的IllegalArgumentException
            throw new IllegalArgumentException("参数必须大于0，当前传入的参数是：" + num);
        }
        return num * num;
    }

    public static void main(String[] args) {
        int input = -3;
        try {
            int result = square(input);
            System.out.println("平方结果是：" + result);
        } catch (IllegalArgumentException e) {
            System.out.println("调用square方法失败：" + e.getMessage());
        }
    }
}

处理时的注意事项

处理IllegalArgumentException的时候需要注意几个要点：

• 不要捕获异常后什么都不做，至少打印日志或者给出提示，否则很难排查问题
• 如果参数校验逻辑比较简单，优先在调用方法前做参数校验，避免异常抛出，比捕获异常效率更高
• catch块中不要做过于复杂的逻辑，避免新的异常抛出导致问题更难定位
• 如果是公共方法，建议在方法注释中说明可能抛出的IllegalArgumentException的场景，方便调用方提前处理

结合参数校验的最佳实践

除了捕获异常，更推荐在方法入口处提前做参数校验，从根源上减少IllegalArgumentException的抛出，比如使用Java自带的Objects类做非空校验：

import java.util.Objects;

public class ParamValidateDemo {
    public static void processString(String str) {
        // 提前校验参数，为空则抛出带提示的异常，避免后续逻辑出错
        Objects.requireNonNull(str, "传入的字符串参数不能为空");
        // 后续业务逻辑
        System.out.println("字符串长度是：" + str.length());
    }

    public static void main(String[] args) {
        try {
            processString(null);
        } catch (IllegalArgumentException e) {
            System.out.println("参数校验失败：" + e.getMessage());
        }
    }
}

通过提前校验参数，可以在异常抛出时就给出明确的提示，也能让代码的逻辑更清晰，配合try-catch处理意外情况，能让程序的稳定性得到很大提升。

JavaIllegalArgumentException异常处理try-catch修改时间：2026-06-06 07:31:38