Java中`NumberFormatException`是编程实践中一个常见的运行时异常，它通常发生在尝试将一个格式不正确的字符串转换为任何数值类型（如`int`、`long`、`float`或`double`）时。理解此异常的根源并掌握其处理方法，对于编写健壮的Java应用程序至关重要。本文将聚焦于`String`到`int`的转换场景，深入分析导致`NumberFormatException`的原因，并提供详细的解决方案和最佳实践。
理解NumberFormatException
NumberFormatException是IllegalArgumentException的一个子类，当应用程序尝试将字符串转换为数字类型，但该字符串不符合目标数字类型的有效格式时，就会抛出此异常。例如，字符串"abc"无法转换为整数，字符串"12.34"无法直接转换为int类型，而字符串"12 34"则更是一个典型的陷阱。
Integer.parseInt() 方法的工作原理
Integer.parseInt(String s)是Java中用于将字符串转换为int基本数据类型的主要方法。它的核心要求是：
- 纯数字字符串：输入的字符串s必须只包含数字字符（'0'-'9'）。
- 可选的符号：字符串可以以一个可选的负号（'-'）或正号（'+'）开头。
- 无空白字符：字符串不能包含前导或尾随的空白字符，除非它们被trim()方法移除。
- 单值表示：最关键的一点是，该字符串必须表示一个单一的、有效的整数值。它不能包含任何非数字字符（除了可选的符号），也不能包含多个用空格或其他分隔符隔开的数字。
如果字符串不满足上述任何一个条件，Integer.parseInt()方法就会抛出NumberFormatException。
立即学习“Java免费学习笔记（深入）”；
典型问题场景分析
在提供的代码片段中，问题出现在尝试将List<String>中的元素转换为int数组时，具体代码行如下：
num[i / 2] = Integer.parseInt(b.get(i));
根据错误信息java.lang.NumberFormatException: For input string: "12 24 21 30"，可以推断出b.get(i)返回的字符串是"12 24 21 30"。显然，这个字符串包含多个用空格分隔的数字。Integer.parseInt()方法在接收到这样的字符串时，无法将其作为一个单一的整数进行解析，因此会抛出NumberFormatException。
这通常发生在以下情况：
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
- 从用户输入（如Scanner.nextLine()）读取了一整行文本，而该行包含了多个数值。
- 从文件或网络读取的数据，其中一个字段包含了多个数值。
解决方案：预处理字符串
要解决NumberFormatException，核心思想是在调用Integer.parseInt()之前，确保传递给它的字符串是符合其要求的单个整数格式。对于包含多个数字的字符串，我们需要将其拆分为单独的数字字符串。
1. 使用 String.split() 方法拆分字符串
String.split(String regex)方法是处理此问题的理想工具。它根据给定的正则表达式将字符串拆分为一个字符串数组。
示例代码：
import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;
import java.util.LinkedList; // 模拟原始代码中的 LinkedList
public class StringToIntConversionTutorial {
public static void main(String[] args) {
// --- 模拟原始问题场景 ---
// 假设通过 input.nextLine() 读取到了一行包含多个数字的字符串
String problematicInputString = "12 24 21 30";
// 原始代码中 List<String> b 可能会包含这种多数字符串
List<String> b = new LinkedList<>();
b.add(problematicInputString); // 模拟 b.add(key) 后的情况
System.out.println("--- 原始问题重现与分析 ---");
System.out.println("List<String> b 的第一个元素: "" + b.get(0) + """);
try {
// 这行代码模拟了原始问题中导致 NumberFormatException 的核心逻辑
// 当 b.get(0) 是 "12 24 21 30" 时，Integer.parseInt() 会失败
int parsedValue = Integer.parseInt(b.get(0));
System.out.println("成功解析: " + parsedValue); // 此行不会执行
} catch (NumberFormatException e) {
System.err.println("错误示例：尝试直接解析包含多个数字的字符串时抛出异常：");
System.err.println("异常信息: " + e.getMessage());
System.err.println("原因：Integer.parseInt() 期望单个整数格式的字符串，而不是 "" + b.get(0) + ""。");
}
System.out.println("
--- 正确的解决方案：拆分字符串后逐个解析 ---");
// 假设我们需要从 problematicInputString 中提取所有整数
// 使用 "\s+" 作为分隔符，匹配一个或多个空格
String[] numberStrings = problematicInputString.split("\s+");
List<Integer> resultNumbers = new ArrayList<>();
for (String numStr : numberStrings) {
try {
// 在解析前，使用 trim() 方法去除字符串可能的前后空白，增加健壮性
int num = Integer.parseInt(numStr.trim());
resultNumbers.add(num);
System.out.println("成功解析并添加数字: " + num);
} catch (NumberFormatException e) {
// 捕获并处理单个数字字符串的解析失败情况
System.err.println("警告：无法解析字符串 '" + numStr + "' 为整数。请检查输入格式。");
}
}
System.out.println("
所有成功解析的整数: " + resultNumbers);
// --- 考虑 List<String> b 的另一种情况 (每个元素已经是单个数字字符串) ---
// 如果 List<String> b 的每个元素本身就是单个数字字符串，则可以直接解析
List<String> singleNumberStrings = Arrays.asList("10", "20", "30", "40");
int[] intArray = new int[singleNumberStrings.size()];
System.out.println("
--- List<String> 元素为单个数字字符串的情况 ---");
for (int i = 0; i < singleNumberStrings.size(); i++) {
try {
intArray[i] = Integer.parseInt(singleNumberStrings.get(i));
System.out.println("解析元素 '" + singleNumberStrings.get(i) + "' 为: " + intArray[i]);
} catch (NumberFormatException e) {
System.err.println("警告：无法解析 '" + singleNumberStrings.get(i) + "' 为整数。");
}
}
System.out.println("解析后的整数数组: " + Arrays.toString(intArray));
}
}在上述代码中，problematicInputString.split("\s+")会根据一个或多个空格将字符串"12 24 21 30"拆分成["12", "24", "21", "30"]这样一个字符串数组。然后，我们遍历这个数组，对每个单独的数字字符串调用Integer.parseInt()进行转换。
2. 使用 Scanner 类进行流式解析（如果适用）
如果数据源是System.in、文件或其他输入流，并且数值之间由空格分隔，那么Scanner类提供了更便捷的nextInt()方法。
import java.util.Scanner;
import java.util.ArrayList;
import java.util.List;
public class ScannerExample {
public static void main(String[] args) {
String inputData = "100 200 300 invalid 400"; // 模拟输入数据
// 使用Scanner从字符串中读取整数
try (Scanner scanner = new Scanner(inputData)) {
List<Integer> numbers = new ArrayList<>();
System.out.println("
--- 使用 Scanner.nextInt() 解析 ---");
while (scanner.hasNext()) {
if (scanner.hasNextInt()) { // 检查下一个token是否是整数
numbers.add(scanner.nextInt());
} else {
String invalidToken = scanner.next(); // 读取并跳过非整数token
System.err.println("警告：跳过非整数输入: '" + invalidToken + "'");
}
}
System.out.println("通过Scanner解析的整数列表: " + numbers);
}
}
}Scanner.hasNextInt()方法在读取之前检查下一个标记是否为整数，这提供了一种优雅的方式来处理混合了有效和无效输入的场景。
健壮性考虑：异常处理
在任何字符串到数字的转换过程中，都应该使用try-catch块来捕获NumberFormatException。这使得程序在遇到无效输入时能够优雅地处理错误，而不是直接崩溃。在上述示例中，我们已经在for循环中加入了try-catch块，以处理单个数字字符串可能仍然无效的情况。
总结
NumberFormatException是Java中处理字符串到数字转换时常见的异常。解决它的关键在于确保传递给Integer.parseInt()等转换方法的字符串是符合其要求的单一、有效数字格式。当字符串包含多个数字或非数字字符时，应首先使用String.split()等方法进行预处理，将其分解为独立的数字字符串。对于输入流，Scanner类的nextInt()配合hasNextInt()提供了一种更便捷和健壮的解析方式。通过妥善的字符串预处理和异常处理机制，可以有效避免NumberFormatException，提高程序的健壮性和用户体验。
