Java泛型类指定为String类型时出现ClassCastException的原因与解决

• Java泛型采用类型擦除实现：编译阶段会将所有无上限的泛型参数T替换为Object，你代码中(T[]) new Object[10]的强转仅会触发编译器的unchecked警告，不会执行实际的类型校验。运行时GenericList类的items字段实际类型始终是Object[]，并不会因为你指定了String作为类型参数就变成String[]。
• 编译器会对泛型调用点插入隐式强转：当你实例化GenericList<String>后，编译器会将items字段的静态类型判定为String[]，你用var items = list.items接收时，编译器自动插入了(String[]) list.items的强转逻辑。而Java数组是协变类型，仅支持子类型数组向上转型为父类型数组（比如String[]可以转Object[]），反向转型不合法，运行时检测到实际类型为Object[]就会抛出ClassCastException。

下面提供三种常用的修复方案： #

方案1：避免直接暴露内部数组，仅通过单个元素读取方法取值 #

你原本定义的get(int index)方法本身是安全的，单个元素取值时编译器插入的是单个对象的强转，不会出现数组类型转换异常，代码修改示例如下：

public class Main {
    public static void main(String[] args) {
        var list = new GenericList<String>();
        list.add("a");
        list.add("b");
        // 直接调用get方法取元素，不获取整个数组
        for(int i = 0; i < 2; i++){
            System.out.println(list.get(i));
        }
    }
}

方案2：传入类型Class对象，用反射创建实际类型匹配的数组 #

如果确实需要对外返回对应类型的完整数组，可以在构造GenericList时传入泛型类型的Class对象，通过Array.newInstance创建运行时类型匹配的数组，修改代码如下：

import java.lang.reflect.Array;

public class GenericList<T> {   
    public T[] items;
    private int count;

    // 新增构造方法，传入泛型类型的Class和数组容量
    public GenericList(Class<T> elementType, int capacity) {
        items = (T[]) Array.newInstance(elementType, capacity);
    }

    public void add(T item){
        items[count++] = item;
    }
    public T get(int index){
        return items[index];
    }
    public T[] getItems() {
        return items;
    }
}

调用时指定类型Class即可：

var list = new GenericList<String>(String.class, 10);

方案3：内部使用Object[]存储，返回数组时做类型拷贝 #

如果不想修改构造方法的参数，可以将内部存储数组改为Object[]类型，对外返回数组时手动拷贝为对应类型的数组，代码示例如下：

import java.util.Arrays;

public class GenericList<T> {   
    private Object[] items = new Object[10];
    private int count;

    public void add(T item){
        items[count++] = item;
    }
    public T get(int index){
        return (T) items[index];
    }
    public T[] getItems() {
        return (T[]) Arrays.copyOfRange(items, 0, count);
    }
}

调用时通过getItems()方法获取数组即可：

var items = list.getItems();

内容的提问来源于stack exchange，提问作者Edith