Java中NumberFormatException怎么解决，字符串转数字时如何做合法性校验

在Java编程中，我们经常需要将字符串类型的数值转换为对应的数字类型，比如将"123"转换为整数123，或者将"3.14"转换为浮点数3.14。但如果在转换时字符串的格式不符合数字的要求，就会抛出NumberFormatException异常，导致程序中断运行。

NumberFormatException的产生原因

NumberFormatException属于运行时异常，当尝试将格式不正确的字符串转换为数字时就会触发。常见的触发场景有以下几种：

• 字符串中包含非数字字符，比如"12a3"、"12.3.4"
• 字符串为空或者空字符串
• 字符串表示的数字超出了对应数字类型的取值范围，比如将"9999999999"转换为int类型
• 字符串带有不符合要求的符号，比如"￥123"、"123,"

解决NumberFormatException的常用方法

方法一：使用try-catch捕获异常

最直接的方式是在转换代码外层包裹try-catch块，捕获NumberFormatException后做对应的处理逻辑，比如返回默认值或者提示用户输入格式错误。

public class NumberConvertDemo {
    public static void main(String[] args) {
        String str = "12a3";
        try {
            int num = Integer.parseInt(str);
            System.out.println("转换后的数字为：" + num);
        } catch (NumberFormatException e) {
            // 捕获异常后处理，这里返回默认值0
            System.out.println("字符串格式错误，无法转换为数字，使用默认值0");
            int num = 0;
        }
    }
}

方法二：转换前先做合法性校验

相比于事后捕获异常，提前校验字符串是否符合数字格式可以从根源上避免NumberFormatException的出现，这也是更推荐的做法。

整数合法性校验

可以使用正则表达式判断字符串是否只包含数字字符，同时可以处理正负号的情况。

public class NumberValidateDemo {
    /**
     * 校验字符串是否为合法的整数
     * @param str 待校验的字符串
     * @return 是合法整数返回true，否则返回false
     */
    public static boolean isValidInteger(String str) {
        if (str == null || str.isEmpty()) {
            return false;
        }
        // 正则匹配：可选的正负号，后面跟着1个或多个数字
        return str.matches("^[+-]?\d+$");
    }

    public static void main(String[] args) {
        String testStr1 = "123";
        String testStr2 = "-456";
        String testStr3 = "12a3";
        System.out.println(testStr1 + "是否为合法整数：" + isValidInteger(testStr1));
        System.out.println(testStr2 + "是否为合法整数：" + isValidInteger(testStr2));
        System.out.println(testStr3 + "是否为合法整数：" + isValidInteger(testStr3));
    }
}

浮点数合法性校验

浮点数的格式比整数更复杂，可能包含小数点、正负号、科学计数法表示，对应的正则匹配规则也需要调整。

public class FloatValidateDemo {
    /**
     * 校验字符串是否为合法的浮点数
     * @param str 待校验的字符串
     * @return 是合法浮点数返回true，否则返回false
     */
    public static boolean isValidFloat(String str) {
        if (str == null || str.isEmpty()) {
            return false;
        }
        // 正则匹配：可选正负号，数字部分（整数或小数），可选的科学计数法部分
        return str.matches("^[+-]?(\d+\.?\d*|\.\d+)([eE][+-]?\d+)?$");
    }

    public static void main(String[] args) {
        String testStr1 = "3.14";
        String testStr2 = "-2.5e3";
        String testStr3 = "12.3.4";
        System.out.println(testStr1 + "是否为合法浮点数：" + isValidFloat(testStr1));
        System.out.println(testStr2 + "是否为合法浮点数：" + isValidFloat(testStr2));
        System.out.println(testStr3 + "是否为合法浮点数：" + isValidFloat(testStr3));
    }
}

方法三：处理数字范围超限问题

即使字符串格式符合数字要求，也可能因为超出对应类型的范围导致转换失败，比如将"2147483648"转换为int类型，此时可以在校验时同时判断数值范围。

public class RangeCheckDemo {
    /**
     * 校验字符串是否为合法的int类型数字，且不超过int的取值范围
     * @param str 待校验的字符串
     * @return 合法返回true，否则返回false
     */
    public static boolean isValidIntRange(String str) {
        if (str == null || str.isEmpty()) {
            return false;
        }
        if (!str.matches("^[+-]?\d+$")) {
            return false;
        }
        try {
            // 先转换为long，避免转换时直接抛出异常
            long num = Long.parseLong(str);
            // 判断是否在int的取值范围内
            return num >= Integer.MIN_VALUE && num <= Integer.MAX_VALUE;
        } catch (NumberFormatException e) {
            return false;
        }
    }

    public static void main(String[] args) {
        String testStr1 = "2147483647"; // int最大值
        String testStr2 = "2147483648"; // 超过int最大值
        System.out.println(testStr1 + "是否为合法int：" + isValidIntRange(testStr1));
        System.out.println(testStr2 + "是否为合法int：" + isValidIntRange(testStr2));
    }
}

不同场景下的校验方案选择

如果是简单的业务场景，对性能要求不高，直接使用try-catch包裹转换代码是最省事的方案；如果是高频调用的转换逻辑，或者需要明确给用户提示错误原因，提前做正则校验是更好的选择；如果涉及不同数字类型的转换，还需要额外加入范围校验的逻辑。

另外需要注意，如果使用Integer.parseInt()、Double.parseDouble()这类方法转换，字符串不能包含空格，如果有空格需要提前调用trim()方法去除前后空格，避免不必要的转换失败。

需要注意的是，正则表达式校验只能判断字符串格式是否符合数字要求，无法完全覆盖所有边界情况，实际开发中可以根据业务需求调整校验规则，结合try-catch做双重保障。

NumberFormatExceptionJava字符串转数字合法性校验修改时间：2026-07-14 06:24:27