Java中防止复杂对象外部修改的关键是切断访问路径：构造时深拷贝、getter返回不可变视图、类设计为不可变（final类、private final字段、无setter），并防范序列化绕过风险。

Java 中复杂对象传参时，防止外部修改的关键不是“阻止传参”，而是切断调用方对内部可变状态的访问路径。核心思路是：构造时做保护性拷贝，getter 中不暴露可变引用，类本身设计为不可变。

构造器里必须做深拷贝

如果构造函数接收 List、Map、数组等可变容器，绝不能直接赋值给 final 字段。否则外部仍可通过原集合修改内部状态。

• 用 new ArrayList(source) 或 new HashMap(source) 创建新容器
• 再用 Collections.unmodifiableList() 包装，确保返回视图不可写
• 数组字段要用 Arrays.copyOf() 或 clone()，不能只用 Arrays.asList()

getter 方法要返回安全副本

对外提供状态访问时，不能返回内部可变对象的原始引用。

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

• 集合类字段：返回 Collections.unmodifiableXXX() 包装后的视图
• 自定义对象字段：若该对象本身可变，需返回其拷贝（如 new Person(p)）
• 避免返回 Arrays.asList(array)，它底层仍指向原数组，可被修改

类结构要符合不可变规范

仅靠拷贝不够，类本身得从设计上杜绝修改可能。

• 类声明为 public final
• 所有字段用 private final 修饰
• 不提供任何 setter 或能改变字段值的方法
• 构造器中校验参数非 null（可用 Objects.requireNonNull）

注意序列化带来的绕过风险

Java 默认序列化会跳过构造器，通过反射直接写入 final 字段，破坏不可变性。

• 实现 readObject() 方法并抛出 InvalidClassException
• 或使用 serialPersistentFields 显式控制序列化字段
• 更稳妥的做法是改用 JSON 等显式序列化方式，避开 Java 原生机制

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南