如何在运行时防止 ArrayList 类型参数破坏泛型安全性？_技术教程

java 泛型存在类型擦除，无法在运行时完全阻止原始类型 list 的非法传入；但可通过自定义强类型集合子类（如 stringlist）替代泛型接口，将类型检查前移至构造与方法调用阶段，从根本上杜绝 `list` 伪装为 `list` 导致的 classcastexception。

在 Java 中，泛型仅在编译期提供类型安全，运行时 List 与 List 均被擦除为原始 List。正如示例所示：用户通过未声明泛型的 ArrayList（如 new ArrayList(Arrays.asList(1, 2, 3))）并强制转型为 List 后传入 setList()，编译器不会报错，而 list.get(0) 在首次访问时才抛出 ClassCastException——这种延迟失败极难调试，且破坏了类的封装契约。

最佳实践不是在 setList() 内做遍历校验（低效且不可靠），而是从 API 设计源头拒绝非法输入。 推荐方案是定义一个不可绕过的具体类型，例如 StringList：

public final class StringList extends ArrayList {
    public StringList() { super(); }
    public StringList(int initialCapacity) { super(initialCapacity); }
    public StringList(@NotNull Collection c) {
        super(c.stream().map(Objects::requireNonNull).toList());
    }

    // 所有添加/修改方法均只接受 String，编译期即拦截非 String 元素
    @Override public boolean add(String s) { return super.add(s); }
    @Override public void add(int index, String element) { super.add(index, element); }
    @Override public String set(int index, String element) { return super.set(index, element); }
    @Override public boolean addAll(Collection c) {
        return super.addAll(c.stream().map(Objects::requireNonNull).toList());
    }
}

✅ 关键优势：编译期强约束：StringList 的所有 add/set/addAll 方法签名明确要求 String 参数，任何 Integer、null 或其他类型均无法通过编译；无法被原始类型绕过：List input = new ArrayList() 无法被强制转型为 StringList（StringList sl = (StringList) input; 编译失败）；零运行时开销：无需遍历校验，避免对大数据集的性能损耗；语义清晰：API 明确表达“此字段只接受真正由 String 构成的列表”。

相应地，TestClass 应使用该具体类型：

public static class TestClass {
    private StringList list;

    public void setList(StringList list) {
        this.list = Objects.requireNonNull(list, "list must not be null");
    }

    public StringList getList() {
        // 返回不可变视图可进一步增强安全性（可选）
        return list;
    }
}

⚠️ 注意事项：