只读实体类如何通过 Getter 实现不可变

只定义getter远不足以保证Java实体类的真正不可变性——反射可强行修改私有字段、getter返回可变对象引用会引发外部篡改、序列化与JSON反序列化更可能绕过所有封装逻辑直接注入数据；要实现可靠不可变，必须三管齐下：类和字段均声明为final、所有可变类型在getter中返回不可变视图或深拷贝，并在Spring等框架中显式配置反序列化策略（如@JsonCreator+@JsonProperty）以杜绝字段直写；即便使用Java 14+的record简化了前两步，业务层面的引用防护与序列化治理仍需开发者逐处亲手把关。

为什么只定义 getter 无法真正实现不可变性

只加 getXXX() 方法、不写 setXXX()，只是“写法上隐藏了修改入口”，不是不可变。JVM 不认这个逻辑，反射仍可调用 Field.setAccessible(true) 直接改私有字段；若字段是可变对象（如 ArrayList、HashMap），getter 返回引用后外部仍能修改其内容；序列化/反序列化、JSON 解析等流程也可能绕过 getter 构造对象。

真正不可变需满足的三个硬性条件

缺一不可：

• 类声明为 final（防止子类覆写 getter 或引入可变状态）
• 所有字段声明为 final 且私有（编译期+运行期双重约束）
• 所有可变类型字段（如 List、Date、自定义对象）在 getter 中返回不可变视图或深拷贝，而非原始引用

例如：Collections.unmodifiableList(list) 比直接 return list 安全；LocalDateTime 可直接返回（本身不可变），但 Date 必须 new Date(date.getTime())。

Java 14+ 推荐用 record 替代手写 getter

record 天然满足前两条：自动 final 类 + 所有组件字段 final + 自动生成规范 getter。但注意第三条仍需手动处理：

public record OrderInfo(String id, List<Item> items) {
    public List<Item> items() {
        return Collections.unmodifiableList(items);
    }
}

⚠️ 若 record 组件含可变对象（如 Map），必须重写对应 getter 并封装；否则反序列化时（如 Jackson）可能跳过你的重写方法，直接注入新 map 实例。

Spring Boot 场景下 JSON 反序列化的陷阱

Spring 默认用 Jackson，它会绕过构造器和 getter，通过反射直接设字段值——即使字段是 final，也会用 Unsafe 强行写入（日志里可能看到 Could not set final field 警告但实际成功）。解决方式：

• 禁用默认字段访问：@JsonCreator(mode = JsonCreator.Mode.PROPERTIES) 标在构造器上
• 配合 @JsonProperty 显式绑定参数名
• 确保所有字段初始化仅发生在构造器中（record 自动满足，普通 class 需手动检查）

没做这步，前端传个 {"items": [{"name":"a"}]}，你的 unmodifiableList 就形同虚设。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《只读实体类如何通过 Getter 实现不可变》文章吧，也可关注golang学习网公众号了解相关技术文章。