Mixin 必须与目标类结构严格匹配，方法、字段、构造器签名需完全一致；否则 Jackson 会退回到默认反射逻辑并报错。
可以直接用 ObjectMapper.addMixIn() 绑定一个抽象类或接口作为 Mixin，把注解写在 Mixin 上，Jackson 会在处理目标类时自动应用这些规则——前提是 Mixin 的方法签名、字段名、构造参数必须与目标类严格匹配。
Mixin 类必须和目标类结构完全对齐
Jackson 不会做任何推断或适配。它只比对 Mixin 中声明的成员（方法、字段、构造器）是否能在目标类中找到语义等价的对应项。
- 如果目标类有
getUsername()，Mixin 就得写public abstract String getUsername();，不能少public或改返回类型 - 如果目标类只有私有字段
private String name;且无 getter，Mixin 就得声明同名字段：@JsonProperty String name;，不能写成getName() - 如果目标类反序列化依赖带参构造（比如
new User(String, Integer)），Mixin 就必须定义一个签名一致的构造器，并加上@JsonCreator
常见失败：反序列化时报 InvalidDefinitionException: Cannot construct instance
这是 Mixin 最常卡住的地方。错误本质是 Jackson 找不到合法的“创建方式”：既没有无参构造，Mixin 也没提供 @JsonCreator 构造器或 @JsonSetter 方法。
- 检查目标类是否真有无参构造；没有的话，Mixin 必须补一个带
@JsonCreator的构造器，参数名和类型要和 JSON 字段一一对应 - 确保
@JsonCreator构造器参数都加了@JsonProperty("xxx")，否则 Jackson 不知道哪个 JSON 字段该塞给哪个参数 - 别指望 Mixin 里只写个
@JsonAutoDetect就能自动扫到私有字段——它只影响可见性策略，不解决“怎么实例化”的问题
序列化时字段重命名或忽略失效？检查 Mixin 是否覆盖了所有访问路径
比如目标类同时有字段 private String id; 和方法 public String getId() { return id; }，Jackson 默认优先用 getter。如果你只在 Mixin 里给字段加了 @JsonProperty("uid")，但没屏蔽 getter，最终还是走 getId() 路径，重命名就无效。
- 想强制走字段路径：Mixin 中用
@JsonProperty注解字段，并调用objectMapper.setVisibility(PropertyAccessor.FIELD, JsonAutoDetect.Visibility.ANY) - 想屏蔽某个 getter：Mixin 中对该方法加
@JsonIgnore，哪怕目标类原方法没注解，也会被跳过 - 字段和 getter 同时存在时，两者注解冲突会导致行为不可预测——最稳的方式是只留一条通路
注册 Mixin 必须在首次使用 ObjectMapper 前完成
addMixIn() 是一次性配置，后续再调用不会覆盖已加载的绑定关系。更隐蔽的问题是：Spring Boot 自动配置的 ObjectMapper 可能早已初始化完毕，直接在 Bean 初始化后调用 addMixIn() 无效。
- 手动 new
ObjectMapper()时，在第一次writeValueAsString()或readValue()前注册即可 - 在 Spring 环境下，应通过
Jackson2ObjectMapperBuilder自定义 bean，或实现Jackson2ObjectMapperBuilderCustomizer - Mixin 绑定是 class-level 的，不是 instance-level——同一个
ObjectMapper实例对所有User.class都生效，无法为不同场景切不同规则
真正容易被忽略的是：Mixin 不是“增强”，而是“替代性描述”。它不叠加原有逻辑，而是告诉 Jackson “当遇到这个类时，请假装它是按 Mixin 描述的样子定义的”。所以一旦签名对不上，Jackson 就彻底放弃 Mixin，退回到默认反射逻辑，而那个默认逻辑往往就是报错的根源。
