Java泛型不支持原始类型，仅能用包装类；“原始类型冲突”实为泛型擦除导致的方法签名重复或raw type误用。应避免擦除后同名方法、禁用raw type、谨慎处理反射与反序列化类型安全。

Java 泛型本身不支持原始类型（如 int、double）作为类型参数，只能使用对应的包装类（Integer、Double 等）。所谓“原始类型冲突”，实际是两类常见问题的误称：一是**泛型擦除后方法签名重复**（如多个接口都定义了 void handle(T)），二是**误用原始类型（raw type）导致类型安全失效**。两者都源于擦除机制，但解决路径不同。

避免泛型接口实现时的方法签名冲突

当一个类同时实现多个泛型接口，且这些接口声明了擦除后签名相同的方法（例如都含 void handle(T)），编译器会报错：“method is already defined”。这不是重载失败，而是 JVM 禁止同一类中存在两个擦除后完全一致的方法签名。

• 不要试图靠泛型参数区分重载——擦除后都是 handle(Object)
• 改用语义化命名：比如 processString() 和 validateNumber()，再在各自 @Override 中调用它们
• 若逻辑高度一致，可提取统一抽象接口或采用委托模式，把共性逻辑下沉

禁止使用原始类型（Raw Type）

写 List list = new ArrayList() 是典型隐患。它绕过泛型检查，让编译器把所有元素当作 Object，后续遍历时会触发 Incompatible types 错误或运行时 ClassCastException。

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

• 必须声明完整参数化类型：List<string> list = new ArrayList()</string>
• IDE 中启用 “Raw type usage” 警告，并设为 error 级别
• 方法返回值也需泛型化，避免返回 List，而应返回 List<user></user> 或用 <T> List<T> method(Class<T> type)

应对反射或反序列化引入的类型污染

JSON 解析、RPC 响应、反射调用等场景常绕过编译检查，把错误类型塞进本该类型安全的集合中。

立即学习“Java免费学习笔记（深入）”；

• Jackson 反序列化时禁用 mapper.readValue(json, List.class)，改用 new TypeReference<List<Order>>() {}
• 对旧接口返回的原始集合，封装校验方法：safeCastList(rawList, Order.class)，内部逐元素判断 Order.class.isInstance(item)
• 绝对不要写 (List<Product>) rawList，哪怕加 @SuppressWarnings("unchecked")

需要运行时类型信息时传入 Class 对象

泛型擦除后，List<String> 和 List<Integer> 在运行时都是 List，无法直接获取元素类型。这时不能靠猜测，而要显式传递类型凭证：

• 构造泛型容器时接收 Class<T> 参数，用于 newInstance 或类型校验
• 复杂嵌套泛型（如 Map<String, List<Integer>>）建议用类型令牌（TypeToken）捕获完整签名
• 反射读取泛型字段/方法时，可通过 getGenericXxx() 获取 Type，再解析其实际类型参数