Java常用对象映射类库与Gson

Gson 不推荐用于复杂对象映射，因其不支持嵌套泛型、接口字段、循环引用、条件序列化及内置类型转换，遇日期等需手动写 TypeAdapter且易误伤；MapStruct 编译期生成纯 getter/setter 代码规避反射；Jackson 的 @JsonUnwrapped 可结构展开而 Gson 无等价能力；LocalDateTime 映射需 Jackson 注册 JavaTimeModule 或 Gson 自定义 TypeAdapter；字段语义（如 Optional）在不同库中行为差异源于契约假设不同。

为什么 Gson 不推荐用于复杂对象映射

Gson 的 fromJson() 和 toJson() 在简单 POJO 场景下够用，但遇到嵌套泛型、接口字段、循环引用、日期格式不一致时，会直接抛 JsonParseException 或静默丢失数据。它不支持字段级条件序列化（比如“仅当 status == ACTIVE 时才序列化 remark”），也没有内置的类型转换注册机制——你得手动写 TypeAdapter，而一旦注册了自定义 TypeAdapter，就无法再复用默认行为，容易误伤其他同类型字段。

MapStruct 是怎么绕过反射开销的

MapStruct 在编译期生成具体实现类，不依赖运行时反射。比如你定义一个 @Mapper 接口：

@Mapper
public interface UserMapper {
    UserMapper INSTANCE = Mappers.getMapper(UserMapper.class);
    UserDTO toDTO(User user);
}

编译后会生成 UserMapperImpl，里面是纯 getter/setter 调用，没有 Field.set() 或 Method.invoke()。这意味着：

• 启动快：无运行时类扫描或代理生成
• 可调试：生成代码在 target/generated-sources/annotations

  

  下可见
• 不兼容 Lombok 的 @Builder 链式构造（需显式配 @Mapping(target = "xxx", expression = "java(...)")）

Jackson 的 @JsonUnwrapped 和 Gson 的 @SerializedName 本质不同

@SerializedName("user_name") 只做字段名映射，而 @JsonUnwrapped(prefix = "user_") 是结构展开——前者是字符串重命名，后者会把 User 对象的字段“拍平”进父级 JSON。例如：

class Order {
    @JsonUnwrapped(prefix = "user_")
    private User user;
}

序列化结果是 {"user_id":123,"user_name":"zhang"}，不是 {"user":{"id":123,"name":"zhang"}}。Gson 没有等价能力，强行模拟只能靠 JsonSerializer 手动拼 JsonObject，极易出错。

遇到 LocalDateTime 映射失败，先查 JavaTimeModule 是否注册

Jackson 默认不处理 LocalDateTime，不加配置会报 Cannot construct instance of java.time.LocalDateTime。必须显式注册模块：

ObjectMapper mapper = new ObjectMapper();
mapper.registerModule(new JavaTimeModule());
// 还要禁用默认的 timestamp 行为，否则输出成数字时间戳
mapper.disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS);

Gson 则需要自己写 TypeAdapter，且要注意时区——LocalDateTime 本身不含时区，但 Gson 默认按系统时区解析字符串，跨环境可能出偏差。实际项目中，建议统一用 Instant + ISO-8601 字符串，避免歧义。

真正难的不是选哪个库，而是搞清字段语义是否允许“自动拍平”或“忽略 null”。比如一个 Optional 字段，Gson 默认序列化为 null，Jackson 默认跳过，MapStruct 默认不映射——这三种行为背后是完全不同的契约假设，得看 API 协议怎么约定。