如何解决 java.lang.StringIndexOutOfBoundsException: 字符串索引越界异常问题？亲测有效的解决方法！

StringIndexOutOfBoundsException 是 Java 中处理字符串时常见的异常，表示对字符串的索引超出了其有效范围。

---

1. 报错原因分析

以下是触发此异常的常见原因：

1. 索引越界：尝试访问字符串中不存在的索引位置。
2. 负索引：索引值为负数。
3. 不正确的子串操作：substring() 方法的起始或结束索引非法。
4. 循环处理字符串时索引溢出：循环条件不正确，导致越界访问。

---

2. 解决思路

1. 检查字符串的实际长度。
2. 确认索引是否在合法范围内 [0, length-1]。
3. 修正字符串操作的逻辑，避免非法索引。
4. 添加边界检查以防止潜在的越界问题。

---

3. 解决方法

方法 1：检查字符串长度

在对字符串进行索引操作前，检查字符串长度是否满足需求。

问题代码：

String str = "Hello";
char ch = str.charAt(5); // 索引超出范围

解决方案：

String str = "Hello";
if (str.length() > 5) {
    char ch = str.charAt(5);
}

---

方法 2：修正 substring() 方法的参数

问题代码：

String str = "Hello";
String sub = str.substring(3, 10); // 结束索引超出范围

解决方案：

String str = "Hello";
if (str.length() > 3) {
    String sub = str.substring(3, Math.min(10, str.length()));
    System.out.println(sub); // 防止结束索引超出范围
}

---

方法 3：处理负索引

问题代码：

String str = "Hello";
char ch = str.charAt(-1); // 索引为负数

解决方案： 确保索引值始终为非负：

String str = "Hello";
int index = -1;
if (index >= 0 && index < str.length()) {
    char ch = str.charAt(index);
} else {
    System.out.println("Index is out of bounds!");
}

---

方法 4：避免循环索引越界

问题代码：

String str = "Hello";
for (int i = 0; i <= str.length(); i++) { // 条件错误
    System.out.println(str.charAt(i));
}

解决方案： 修正循环条件，确保不越界：

String str = "Hello";
for (int i = 0; i < str.length(); i++) { // 使用 `<` 而不是 `<=`
    System.out.println(str.charAt(i));
}

---

方法 5：处理空字符串

问题代码：

java


复制代码
String str = "";
char ch = str.charAt(0); // 字符串为空

解决方案： 先检查字符串是否为空：

String str = "";
if (!str.isEmpty()) {
    char ch = str.charAt(0);
} else {
    System.out.println("String is empty!");
}

---

4. 示例代码

以下是一个综合示例，展示如何避免 StringIndexOutOfBoundsException：

public class StringIndexExample {
    public static void main(String[] args) {
        String str = "Hello, Java!";
        
        // 检查字符串长度
        if (str.length() > 5) {
            char ch = str.charAt(5);
            System.out.println("Character at index 5: " + ch);
        } else {
            System.out.println("Index 5 is out of bounds!");
        }

        // 安全截取子串
        int start = 7;
        int end = 15;
        if (start >= 0 && end <= str.length() && start < end) {
            String sub = str.substring(start, end);
            System.out.println("Substring: " + sub);
        } else {
            System.out.println("Invalid substring range!");
        }

        // 安全遍历字符串
        for (int i = 0; i < str.length(); i++) {
            System.out.print(str.charAt(i) + " ");
        }
    }
}

---

5. 总结

避免 StringIndexOutOfBoundsException 的有效方法：

1. 检查索引合法性
   • 索引应在 [0, str.length()-1] 范围内。
2. 处理边界情况
   • 空字符串或超出范围的子串操作需提前检查。
3. 修正逻辑错误
   • 循环条件与 substring() 参数需仔细验证。
4. 添加调试信息
   • 在操作前打印索引值和字符串长度，便于排查问题。

通过以上方法，可以有效解决 StringIndexOutOfBoundsException 问题，提升代码的安全性与稳定性！