Java 集合转数组时，无参 toArray() 方法因泛型擦除只能返回 Object[]，强制转换具体类型数组会抛出 ClassCastException。推荐使用带参 toArray(new T[0])，传入类型一致且长度为 0 的空数组，既能保证类型安全，又能利用 JVM 优化减少内存分配。

命令速用版

以下是代码修正的直接对比，复制即可替换原有逻辑。

错误写法（会报错）：

List<String> list = Arrays.asList("a", "b");
// 运行时抛出 ClassCastException
String[] arr = (String[]) list.toArray();

正确写法（推荐）：

List<String> list = Arrays.asList("a", "b");
// 传入长度为 0 的空数组
String[] arr = list.toArray(new String[0]);

为什么会这样

根本原因是 Java 的泛型擦除机制导致运行时无法创建具体类型的数组。无参 toArray() 返回 Object[]，而 Object[] 和 String[] 在 JVM 看来是不同的运行时类型，禁止直接向下强转。传入 new T[0] 是让 JDK 内部通过反射创建正确类型的数组，且长度为 0 时性能最佳，因为 JVM 会对空数组做优化，避免传入 list.size() 可能导致的并发修改问题或多余分配。

分步处理

按以下步骤排查和修复现有代码中的 toArray 用法。

步骤 1：定位调用点

在 IDE 中全局搜索 .toArray()，筛选出无参版本或强制转换的版本。

步骤 2：替换为带参方法

将 list.toArray() 修改为 list.toArray(new 类型 [0])，确保泛型类型匹配。

步骤 3：检查数组长度逻辑

确认后续代码不依赖数组特定初始容量，toArray 返回的数组长度等于集合当前 size。

步骤 4：回滚提醒

如果旧代码依赖 Object[] 的特性，修改后需回归测试，确保业务逻辑兼容具体类型数组。

怎么验证是否生效

通过编译检查和运行时测试确认修复效果。

检查点 1：编译通过

代码不再有 unchecked cast 警告，类型匹配正确。

检查点 2：运行无异常

程序运行时不再抛出 ClassCastException，尤其是集合不为空时。

检查点 3：内容验证

打印数组内容，确认元素齐全且没有多余的 null 值（传入空数组不会产生 null 填充）。

常见坑

列出开发中容易出错的细节，避免修复后引入新问题。

坑 1：强制转换 Object[]

不要写 (String[]) list.toArray()，即使集合里全是 String，运行时数组类型仍是 Object[]，强转必崩。

坑 2：传入数组过大

若传入 new String[list.size() + 5]，返回数组多余位置会被填充 null，后续遍历可能抛出 NullPointerException。

坑 3：并发修改风险

传入 new T[list.size()] 时，若集合在 size() 调用和 toArray 内部遍历间被修改，可能导致数组长度不够或浪费，传 0 由内部处理更安全。

常见问题

为什么不能直接用 list.toArray() 强转？

因为无参方法返回的是 Object[] 实例，JVM 禁止将 Object[] 强制转换为 String[] 等具体类型数组，运行时会抛 ClassCastException。

传入 new T[0] 和 new T[size] 有什么区别？

传入 new T[0] 性能更好且语义清晰，JVM 会动态创建合适大小数组；传入 new T[size] 在并发场景下可能因 size 变化导致扩容或浪费。

集合为空时 toArray 返回什么？

集合为空时，toArray(new T[0]) 返回一个长度为 0 的同类型数组，不会返回 null，可以直接遍历。

参考来源

• Java 开发手册中为什么要求集合转数组 toArray 时禁止使用无参方法，而使用传参长度为 0 的空数组
• 在 Java 中如何将集合转换为数组_Java 集合转数组机制解析
• 集合转数组必须使用集合的 toArray(T[] array),传入的是型完全一致、长度为 0 的空数组的原因
• Java 中如何将集合转换为数组_toArray 参数与强转的规范实践
• Java 集合转数组:toArray 方法深度解析与实践指南