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。例如：
立即学习“Java免费学习笔记（深入）”；
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<String> 字段，Gson 默认序列化为 null，Jackson 默认跳过，MapStruct 默认不映射——这三种行为背后是完全不同的契约假设，得看 API 协议怎么约定。
