ArrayIndexOutOfBoundsException的报错末尾数字是访问下标,length后数字是数组实际长度,合法下标范围为0到length-1;该异常为运行时异常,IDE不标红,需检查边界逻辑、循环条件、集合转数组后的长度确认及上游状态控制。

数组越界异常的典型报错信息怎么看
Java 中触发 ArrayIndexOutOfBoundsException 时,堆栈里最值得盯住的是异常消息末尾的数字,比如 java.lang.ArrayIndexOutOfBoundsException: Index 5 out of bounds for length 5。这个 5 是你访问的下标,length 5 表示数组实际长度为 5,合法下标是 0 到 4——所以访问 5 就越界了。
注意:这个异常不是编译错误,只有运行到那行才会抛出;IDE 通常不会标红,容易漏检。
常见越界场景和对应修复方式
多数越界不是手误,而是逻辑没兜住边界条件。下面这些写法在循环、截取、转换时高频出问题:
- 用
for (int i = 0; i 遍历 —— 应该是i - 调用
Arrays.copyOf(arr, arr.length + 1)后直接访问新数组第arr.length位,忘了新数组长度已是arr.length + 1,最大下标是arr.length,但旧逻辑可能还按老长度算 -
str.substring(0, str.length())看似安全,但如果str是null,会先抛NullPointerException;而str.substring(str.length(), str.length() + 1)会直接越界 - 多线程共享数组且未同步,一个线程刚扩容完,另一个线程还拿着旧的
length值去访问
用调试和日志快速定位越界位置
光看堆栈有时不够,尤其当数组是方法参数或中间计算结果时。建议在可疑代码前加防御性日志:
立即学习“Java免费学习笔记(深入)”;
System.out.println("Accessing index " + i + " on array of length " + arr.length);
更稳妥的做法是加断言(开发/测试环境):
if (i < 0 || i >= arr.length) {
throw new IllegalArgumentException("Index " + i + " invalid for array length " + arr.length);
}
或者用 Objects.checkIndex(i, arr.length)(Java 9+),它会在越界时抛出带上下文的异常,比原生异常更容易追溯。
集合转数组后忘记检查长度
从 List 转数组很常见,但容易忽略返回数组可能为空或长度不匹配:
Listlist = Arrays.asList("a", "b"); String[] arr = list.toArray(new String[0]); // 推荐:让 JVM 自动分配 // ❌ 错误假设:arr.length == list.size() 总成立?其实 new String[0] 是安全的,但若写成 new String[2] 就可能被复用,导致后续操作误判长度
关键点:
- 永远别依赖
list.toArray(new String[n])中的n来判断结果数组长度,要用arr.length重新确认 - 如果用
toArray()无参重载(返回Object[]),再强转类型数组时,运行时不会报越界,但可能引发ClassCastException,间接掩盖真实问题
越界本身不难修,难的是它常是上游逻辑失控的表征——比如循环变量没重置、状态没清理、并发修改没防护。看到 ArrayIndexOutOfBoundsException 时,先别急着改下标,看看谁给的下标、谁管的长度、谁动了数组本身。










