Java中通用JSON解析需解决泛型擦除问题，通过TypeReference或JavaType传递完整类型信息，由Jackson自动反射构造对象并设值，再封装泛型工具方法统一调用。

Java 中通过泛型和反射实现通用 JSON 解析映射，核心在于：**让解析方法能接收任意类型 Class，并在运行时把 JSON 字符串准确转成该类型的实例**。关键难点是泛型擦除后如何还原类型信息，以及如何安全调用反射构造对象、设值。下面分三块讲清楚怎么做（以 Jackson 为例，其他库逻辑类似）：

1. 泛型类型信息不能丢：用 TypeReference 或 ParameterizedType

直接写 List<User> 会被擦除成 List，Jackson 无法知道元素是 User。必须显式传递带泛型的类型描述：

• 对于简单泛型集合（如 List<User>），用 Jackson 的 TypeReference：

  List<User> users = mapper.readValue(json, new TypeReference<List<User>>() {});

• 对于嵌套泛型或更复杂结构（如 Map<String, List<Order>>），可用 JavaType 构造：

  JavaType type = mapper.getTypeFactory().constructParametricType(Map.class, String.class, mapper.getTypeFactory().constructParametricType(List.class, Order.class));
  Map<String, List<Order>> data = mapper.readValue(json, type);

2. 反射创建实例并填充字段：靠 ObjectMapper 自动完成，无需手动 new + set

不用自己写反射创建对象、遍历字段赋值——Jackson 内部已基于反射做了完整支持。你只需确保目标类满足基本要求：

Feishu calendar sync, local ics to json data for AI agent

将ICS日历文件转为JSON格式，用于飞书日历导入导出及数据集成。

下载

• 类有 **无参构造函数**（Jackson 默认需要；若没有，可加 @JsonCreator 指定静态工厂方法）
• 字段有 public 访问权限，或提供 public 的 getter/setter（Jackson 默认按 setter 或字段直写）
• 如需忽略某些字段，加 @JsonIgnore；指定 JSON 字段名，用 @JsonProperty("user_name")
• 若字段名和 JSON 键不一致且不想加注解，可配置 mapper.setPropertyNamingStrategy(PropertyNamingStrategies.SNAKE_CASE)

3. 封装一个泛型解析工具方法

把类型信息和 JSON 解析逻辑收拢，对外暴露简洁接口：

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

• 解析单个对象：

  public static <T> T fromJson(String json, Class<T> clazz) throws JsonProcessingException {
    return mapper.readValue(json, clazz);
  }

• 解析带泛型的集合（必须用 TypeReference）：

  public static <T> List<T> fromJsonList(String json, Class<T> elementClass) throws JsonProcessingException {
    JavaType type = mapper.getTypeFactory().constructParametricType(List.class, elementClass);
    return mapper.readValue(json, type);
  }

• 更通用的版本（支持任意参数化类型）：

  public static <T> T fromJson(String json, TypeReference<T> typeRef) throws JsonProcessingException {
    return mapper.readValue(json, typeRef);
  }

补充提醒

反射本身不参与“泛型解析”主流程，而是 Jackson 底层用它做实例化和属性注入；你的代码只需正确传入类型信息。Gson 同理，用 TypeToken 替代 TypeReference。注意处理异常（JsonProcessingException）、空值、时间格式（配置 SimpleDateFormat 或用 @JsonFormat）。