Java反射无法直接获取泛型类型信息，需通过TypeReference或TypeToken显式捕获泛型实参，再结合反射构造对象；泛型实例化仍基于原始类型，安全性依赖编译期约束与运行时校验。

Java 反射本身不保留泛型类型信息（类型擦除），所以无法直接通过反射“安全地”获取泛型参数并实例化带类型参数的对象。但可以通过一些约定和技巧，在运行时尽可能还原类型信息，实现类型安全的泛型对象创建。核心思路是：**用 TypeToken 或 Class + TypeReference 显式捕获泛型类型，再结合反射构造器调用完成实例化**。

用 TypeReference 保留泛型类型信息

这是最常用也最实用的方式，尤其在 Jackson、MyBatis 等框架中广泛使用。TypeReference 利用匿名子类的 getClass().getGenericSuperclass() 获取父类声明的泛型实参，绕过类型擦除。

• 定义一个泛型抽象类，如 com.fasterxml.jackson.core.type.TypeReference
• 创建子类实例时写成 new TypeReference>() {} —— 匿名子类会把 List 记录在字节码中
• 调用其 getType() 方法即可拿到 ParameterizedType，从中提取原始类型和实际类型参数

手动构造 ParameterizedType（适用于已知类型结构）

当泛型类型可预知（如 List、Map），可手动生成 ParameterizedType 实例，用于后续反射操作（例如设置字段类型、调用泛型方法）。

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

• 使用 sun.reflect.generics.reflectiveObjects.ParameterizedTypeImpl（非标准 API，不推荐生产环境）
• 更稳妥的做法：用 java.lang.reflect.ParameterizedType 的实现类（如自定义或借助第三方库如 Guava 的 TypeToken）
• 示例：new TypeToken>() {}.getType() 返回完整泛型类型，可用于 newInstance 后的类型校验

反射创建实例时注意构造器与泛型无关

泛型只存在于编译期和部分元数据中，实际构造对象时不需要泛型参数。Class.newInstance() 或 Constructor.newInstance() 都只依赖原始类型（raw type）。

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

• 例如 Class listClass = ArrayList.class；listClass.getDeclaredConstructor().newInstance() 返回的是 ArrayList，不是 ArrayList
• 泛型安全性靠编译器和后续强转保障（如 (List) list），而非反射本身
• 若需确保返回对象符合某泛型契约，可在 newInstance 后用 instanceof + 类型检查辅助验证（如判断是否为 ArrayList，再检查元素类型是否匹配）

结合泛型工厂类封装安全创建逻辑

将类型信息与反射解耦，封装成泛型工厂，提升复用性和类型安全性。

• 定义泛型工厂接口：interface GenericFactory { T createInstance(); }
• 实现类持有一个 TypeReference 字段，在构造时传入，createInstance() 中解析类型并反射创建原始对象
• 调用方只需 new GenericFactory

注意：真正的“泛型安全实例化”在运行时无法 100% 保证（因擦除不可逆），所谓安全是指通过显式类型引用 + 编译期约束 + 运行时校验，把类型风险控制在可控范围内。