java泛型常见错误有哪些

在 Java 泛型使用过程中，开发者常犯或容易误解的错误主要集中在类型擦除、边界使用、数组与泛型、通配符、类型推断等方面。下面按“常见错误 + 原因 + 正确做法”的方式说明。

一、把泛型当“运行时类型”用（类型擦除误解）

❌ 错误示例

public <T> void test() {
    if (T instanceof String) { } // 编译错误
}

List<String> list = new ArrayList<>();
if (list instanceof List<String>) { } // 编译错误

原因

Java 泛型是编译期特性，运行时会进行类型擦除，泛型信息不存在于 JVM 中。

✅ 正确做法

• 使用 Class<T> 参数

public <T> void test(Class<T> clazz) {
    if (clazz == String.class) { }
}

二、创建泛型数组

❌ 错误示例

List<String>[] lists = new List<String>[10]; // 编译错误

原因

数组在运行期需要具体类型，而泛型在运行期被擦除。

✅ 正确做法

List<String>[] lists = (List<String>[]) new List[10]; // 不推荐但可行

或更好：

List<List<String>> lists = new ArrayList<>();

三、使用基本类型作为泛型参数

❌ 错误示例

List<int> list = new ArrayList<>(); // 编译错误

原因

泛型只接受引用类型。

✅ 正确做法

List<Integer> list = new ArrayList<>();

四、误用泛型静态成员

❌ 错误示例

class Box<T> {
    static T value; // 编译错误
}

原因

静态成员属于类，不属于某个泛型实例。

✅ 正确做法

class Box<T> {
    static Object value;
}

五、错误理解通配符（? extends / ? super）

❌ 错误示例

List<? extends Number> list = new ArrayList<>();
list.add(1); // 编译错误

原因

? extends Number 表示“某种未知子类”，不能安全写入。

✅ PECS 原则

• Producer → extends
• Consumer → super

List<? super Integer> list = new ArrayList<>();
list.add(1); // OK

六、忽略泛型警告（unchecked）

❌ 错误做法

List list = new ArrayList();
list.add("abc");
List<Integer> ints = list; // 警告但能编译

风险

运行时 ClassCastException

✅ 正确做法

始终声明泛型类型：

List<Integer> ints = new ArrayList<>();

七、泛型方法类型推断失败

❌ 错误示例

public <T> T get() { return null; }

String s = get(); // 可能推断失败

✅ 明确类型

String s = this.<String>get();

八、在 catch 中使用泛型异常

❌ 错误示例

try {
} catch (T e) { } // 编译错误

原因

异常类型必须在编译期确定。

九、混淆泛型类与泛型方法

❌ 错误示例

class Utils {
    <T> T convert(T t) { return t; }
}

调用时误以为和类泛型有关。

✅ 明确区分

• 类泛型：class Box<T>
• 方法泛型：<T> T method()

十、过度使用通配符

❌ 反例

List<? extends ? super Number>

✅ 建议

只在 API 边界（参数/返回值）使用通配符，内部实现用具体泛型。

总结速查表

如果你愿意，我也可以：

• 给你一套泛型面试题
• 用真实业务代码演示泛型错误
• 深入讲 类型擦除底层实现

你想看哪一个？