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)</t></t></t>
应对反射或反序列化引入的类型污染
JSON 解析、RPC 响应、反射调用等场景常绕过编译检查，把错误类型塞进本该类型安全的集合中。
- Jackson 反序列化时禁用
mapper.readValue(json, List.class)，改用new TypeReference<list>>() {}</list> - 对旧接口返回的原始集合，封装校验方法：
safeCastList(rawList, Order.class)，内部逐元素判断Order.class.isInstance(item) - 绝对不要写
(List<product>) rawList</product>，哪怕加@SuppressWarnings("unchecked")
需要运行时类型信息时传入 Class 对象
泛型擦除后，List<string></string> 和 List<integer></integer> 在运行时都是 List，无法直接获取元素类型。这时不能靠猜测，而要显式传递类型凭证：
- 构造泛型容器时接收
Class<t></t>参数，用于 newInstance 或类型校验 - 复杂嵌套泛型（如
Map<string list>></string>）建议用类型令牌（TypeToken）捕获完整签名 - 反射读取泛型字段/方法时，可通过
getGenericXxx()获取Type，再解析其实际类型参数
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
