运行时保护类不受setList方法非法List参数影响的最佳实践

针对你遇到的问题——用户通过强制转换无类型List传入非String元素的列表，导致TestClass内部状态损坏且错误延迟到获取元素时才爆发，以下是几种无需复制大列表的最佳实践：

1. 使用类型检查包装器（Collections.checkedList） #

Java提供的Collections.checkedList可以为原列表创建一个类型检查的视图，无需复制整个列表。它会在每次添加、修改元素操作时立即校验类型，一旦发现非String元素就抛出ClassCastException，避免非法元素进入列表；同时，后续任何尝试向该列表插入非String元素的操作都会被立刻拦截。

修改后的TestClass实现：

import java.util.Collections;
import java.util.List;

public static class TestClass {
    private List<String> list;

    public void setList(List<String> list) {
        // 包装为带类型检查的列表，原列表不会被复制
        this.list = Collections.checkedList(list, String.class);
    }

    public List<String> getList() {
        return list;
    }
}

注意：这个包装器不会校验列表中已存在的非法元素，若原列表本身就包含非String元素，第一次调用get()时仍会抛出异常，但后续的修改操作会被严格拦截。

2. 结合部分元素校验提前发现问题 #

如果需要提前检测原列表中已存在的非法元素，又不想遍历整个大列表，可以选择校验列表的第一个元素（或前几个元素），在set方法中直接抛出异常，避免错误延迟到用户使用时才爆发：

import java.util.Collections;
import java.util.List;

public static class TestClass {
    private List<String> list;

    public void setList(List<String> list) {
        if (list != null && !list.isEmpty()) {
            Object firstElem = list.get(0);
            if (!(firstElem instanceof String)) {
                throw new IllegalArgumentException("列表包含非String类型元素");
            }
        }
        // 同时包装为类型检查列表，防止后续添加非法元素
        this.list = Collections.checkedList(list, String.class);
    }

    public List<String> getList() {
        return list;
    }
}

这种方式仅需少量性能开销，就能提前拦截大部分明显的非法输入，同时保留对后续修改操作的类型校验。

3. 返回不可变视图（可选） #

如果TestClass不需要允许外部修改该列表，可以在getList()方法中返回不可变视图，进一步避免外部非法修改：

public List<String> getList() {
    return Collections.unmodifiableList(list);
}

结合checkedList使用，既能保证列表内部状态不被篡改，又能严格校验类型。

核心原理说明 #

Java泛型采用擦除机制，编译器无法在编译阶段校验无类型List的实际元素类型，导致强制转换时不会报错。而checkedList利用运行时类型检查，弥补了泛型擦除的缺陷，将类型错误的触发时机提前到元素修改阶段，避免TestClass的内部状态被非法数据污染。

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