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

时间：2026-07-15

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

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

搞懂边界：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);
}