只定义 getter 无法实现真正不可变性,因反射可修改私有字段、getter 返回可变对象引用会导致外部篡改、序列化/JSON 反序列化可能绕过 getter 直接赋值。

为什么只定义 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<String, Object>),必须重写对应 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 就形同虚设。

















