Java反射操作数组全解析

本文深入剖析了Java反射中操作数组（尤其是基本类型数组）的核心难点与陷阱：必须使用Array.newInstance()而非new int[]来创建数组，读写时需严格匹配基本类型与包装类并手动处理强转，多维数组需分层构建与访问，Array.set()的类型校验完全依赖运行时且无自动装拆箱，而getLength()对null返回0的反直觉行为极易引发逻辑误判——所有问题根源都在于反射机制对基本类型、包装类和null的特殊处理方式，稍有不慎便会导致IllegalArgumentException或静默错误，堪称Java反射中最易踩坑的“薄冰地带”。

怎么用 java.lang.reflect.Array 创建和读写基本类型数组

不能直接 new int[] 通过反射，必须走 Array.newInstance()。它对基本类型和引用类型行为一致，但传参方式容易错：第二个参数是长度（int），不是维度数组——很多人误传 new int[]{5} 给一维数组，结果创建出长度为 1 的 int[]，里面第一个元素是 5。

• 创建 int[10]：用 Array.newInstance(int.class, 10)，不是 Array.newInstance(int.class, new int[]{10})
• 读取第 3 个元素：用 Array.get(arr, 2)，返回 Object；对基本类型需强转，比如 (int) Array.get(arr, 2)
• 写入值：用 Array.set(arr, index, value)，value 必须是包装类或对应基本类型字面量（Array.set(arr, 0, 42) 合法，Array.set(arr, 0, Integer.valueOf(42)) 也合法）

Array.set() 报 IllegalArgumentException: argument type mismatch 怎么办

这个错几乎都因为传了错误类型的 value。反射不自动拆箱/装箱，int[] 要求 int 或 Integer，但如果你传了 Long、Double 甚至 String，就炸。更隐蔽的是泛型擦除后传错——比如你拿到一个 Object 类型变量，以为是 Integer，实际是 Long。

• 检查 value.getClass() 是否与数组组件类型兼容：对 int[]，只接受 int.class 或 Integer.class
• 避免从 Map.get() 或 JSON 解析结果直传；先做类型判断或显式转换：Array.set(arr, i, ((Number) obj).intValue())
• Array.setBoolean() 等专用方法不存在，全靠通用 set()，所以类型校验全在运行时，没编译期保护

多维数组怎么用 Array 操作

二维 int[][] 是 int[].class 类型的数组，不是 int.class。所以创建时第二参数是“每行长度”，但第一维长度得另算——Array.newInstance(int[].class, 3) 创建的是长度为 3 的 int[][]，每个元素初始为 null，必须再逐个 Array.set() 上去。

• 创建 int[2][3]：先 Object arr2d = Array.newInstance(int[].class, 2)，再循环两次 Array.set(arr2d, i, Array.newInstance(int.class, 3))
• 读 arr2d[1][2]：先 Object row = Array.get(arr2d, 1)，再 Array.get(row, 2)；不能一步到位
• 性能敏感场景慎用：每次 get/set 都有类型检查开销，嵌套越深越慢，比直接下标访问慢一个数量级

为什么 Array.getLength() 有时返回 0 却不报空指针

它对 null 返回 0，不是抛 NullPointerException。这很反直觉——其他反射方法（如 Array.get()）遇到 null 数组会直接崩，唯独 getLength() 偷懒返回 0。结果就是你可能误判数组存在且为空，实际是根本没初始化。

• 调用前务必先判空：if (arr == null) throw new IllegalArgumentException("array is null")
• 别依赖 getLength() == 0 区分“空数组”和“未初始化”，二者行为完全一样
• 工具类封装时最容易漏这点，比如写了个 safeGetLength(Object arr)，忘了加空检查，下游逻辑就静默错

今天关于《Java反射操作数组全解析》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！