Java中 StringIndexOutOfBoundsException 字符串截取越界怎么解决

字符串截取越界（StringIndexOutOfBoundsException）大概是Ja va初学者最常遇到的异常之一，但说穿了其实很简单——就是代码访问了一个字符串里根本不存在的索引位置。抛开语言自带的限制不谈，这种问题的核心解法其实就一句话：在截取之前先做边界校验，确保起始和结束索引都在合法范围内。

搞懂边界：substring的索引规则

先看一个最典型的场景——String.substring(int beginIndex, int endIndex)。这个方法对参数有一个硬性要求：

• 0 ≤ beginIndex ≤ endIndex ≤ string.length()

这三个不等式里任何一个不满足，系统就会直接抛出异常，不会给你留任何情面。

随手写出来的代码，可能踩这么几个坑：

• 直接用用户输入或某个计算结果当作索引，完全没校验字符串长度——比如 str.substring(5, 10)，但 str.length() 只有 3 个字符。
• 用 indexOf 查找分隔符，拿到结果后没判断它是不是 -1，就直接拿这个值去截取。
• 对空字符串甚至 null 直接调用 substring，那更是想不抛异常都难。

✅ 正确的做法其实很简单：先判断，再截取。

if (str != null && str.length() >= 10) {
    String sub = str.substring(5, 10);
} else {
    String sub = ""; // 或者抛自定义异常、返回默认值
}

安全截取方法论：三个常用套路

把边界校验封装成可复用的逻辑，是规避这类问题的根本手段。经验表明，以下几种模式在实战中用得最多：

• 按长度安全截取前 N 位：str.substring(0, Math.min(n, str.length()))
• 从某位置开始取最多 m 个字符：str.substring(start, Math.min(start + m, str.length()))
• 按分隔符分割并安全取段：先 int idx = str.indexOf("-");，再 if (idx != -1) { ...substring(0, idx)... }

这三个套路几乎覆盖了日常开发中 90% 的截取场景。

工具类加持：让代码更健壮

如果你的项目引入了 Apache Commons Lang，那 StringUtils 简直就是帮你把边界校验这件事给包圆了：

• StringUtils.substring(str, 5, 10)：自动处理 null 和越界，返回 null 或截取结果
• StringUtils.left(str, 5)、StringUtils.right(str, 3)：安全取左右子串
• StringUtils.substringBefore(str, "-")：按分隔符安全截取前半部分

如果项目里还不能引入第三方库，自己封装一个轻量工具方法也不难：

public static String safeSubstring(String s, int from, int to) {
    if (s == null || from < 0 || from > to) return "";
    int len = s.length();
    int start = Math.max(0, Math.min(from, len));
    int end = Math.max(start, Math.min(to, len));
    return s.substring(start, end);
}

调试时快速定位越界原因

遇到异常的时候，别光盯着堆栈看。重点查三件事：

• 打印原始字符串内容和长度：System.out.println("str='" + str + "', len=" + str.length());
• 打印你要用的索引值：System.out.println("begin=" + begin + ", end=" + end);
• 确认这些索引是否由外部输入、正则匹配、JSON 解析等不可控来源产生——这些地方最容易埋雷

说到底，这是个逻辑问题，不是技术难题。但正因为它不复杂，才更容易被随手写过去，直到线上报错才想起来排查。前置校验做好，后面就省心多了。