ArrayIndexOutOfBoundsException最常见原因是索引超出数组边界;Java数组合法索引范围是0到arr.length-1;建议访问前检查索引范围或使用Optional封装安全获取逻辑。

检查数组长度再访问索引
Java 中 ArrayIndexOutOfBoundsException 最常见原因是用了一个超出数组边界的索引,比如对长度为 5 的数组访问 arr[5] 或 arr[-1]。Java 数组下标从 0 开始,合法范围是 0 到 arr.length - 1,arr.length 本身不可访问。
实操建议:
立即学习“Java免费学习笔记(深入)”;
- 每次用变量做索引前,先判断:
if (i >= 0 && i - 循环遍历时优先用增强 for 循环(
for (Type e : arr)),彻底避开索引计算 - 若必须用传统 for,写成
for (int i = 0; i ,别用或硬编码数字
注意字符串和集合的“类数组”操作陷阱
很多人误以为 String.charAt() 或 List.get() 和数组访问一样“安全”,其实它们同样抛 ArrayIndexOutOfBoundsException(或其子类,如 StringIndexOutOfBoundsException、IndexOutOfBoundsException)。这些异常在 JVM 层常被统一捕获处理,但逻辑上等价。
实操建议:
立即学习“Java免费学习笔记(深入)”;
-
str.charAt(i)前务必检查i >= 0 && i -
list.get(i)前检查i >= 0 && i ;更稳妥用list.isEmpty() ? null : list.get(0)这类防御式写法 - 避免把
substring(0, str.length() + 1)这类明显越界的调用留在测试之外
多线程环境下数组引用可能为 null
虽然 ArrayIndexOutOfBoundsException 名字里带“index”,但实际运行中如果数组引用本身是 null,再访问任何索引都会触发 NullPointerException。不过开发时容易混淆——尤其在并发修改或懒初始化场景下,误判为“索引问题”而忽略空指针根源。
实操建议:
立即学习“Java免费学习笔记(深入)”;
- 在访问数组前加非空校验:
if (arr != null && i >= 0 && i - 使用
Objects.nonNull(arr)配合断言或日志,快速定位是空引用还是真越界 - 共享数组若被多线程读写,考虑用
CopyOnWriteArrayList替代原生数组,或加同步块保护读写逻辑
用 Optional 或工具方法封装安全访问
反复写边界检查冗长又易漏,可封装通用逻辑。Java 8+ 的 Optional 不直接支持数组,但可自建工具方法返回 Optional;Guava 的 Objects.firstNonNull() 或 Apache Commons Lang 的 ArrayUtils.get() 也提供默认值兜底。
示例(轻量封装):
public staticOptional safeGet(T[] arr, int index) { if (arr == null || index < 0 || index >= arr.length) { return Optional.empty(); } return Optional.of(arr[index]); }
调用:safeGet(myArray, 10).orElse("default") —— 比层层 if 更清晰,也避免异常打断流程。
真正难防的是动态计算索引的场景:比如 arr[i * 2 + 1],这时候光检查 i 不够,得算整个表达式结果是否越界。这种地方最容易漏检,建议提取为局部变量并加注释说明取值范围。










