Record类不能直接加字段但可加方法；必须用compact constructor做校验，方法需保持不可变性，禁用Lombok，超出数据载体范畴应改用普通class。
Record类不能直接加字段，但可以加方法
Java的record本质是不可变数据载体，编译器会自动生成final字段、构造器、equals/hashCode/toString。你不能在record里声明普通字段（比如private String cache），但**可以合法添加实例方法、静态方法、甚至重写toString等标准方法**——只要不破坏不可变性语义。
常见错误现象：java: illegal start of type 或 java: record component declaration expected，通常是因为误在record体里写了字段声明，或用了public/private修饰方法（record中方法默认就是public，加访问修饰符反而报错）。
- 方法必须是实例方法或static方法，不能有实例初始化块、构造器（除非用compact constructor）
- 如果需要校验逻辑，优先放在compact constructor里，而非构造后调用方法
- 避免在方法里修改参数或返回可变对象引用（比如返回
new ArrayList(list)而不是list）
用compact constructor做构造时校验
record允许一个特殊构造器：compact constructor，它不声明参数，但能访问所有record组件，且在自动生成的构造逻辑前后执行。这是放校验逻辑最自然的位置——既早于对象完全构建，又不破坏record语义。
使用场景：身份证号格式检查、邮箱非空、数值范围限制等初始化强约束。
立即学习“Java免费学习笔记（深入）”；
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
示例：
record User(String email, int age) {
public User {
if (email == null || !email.contains("@")) {
throw new IllegalArgumentException("Invalid email");
}
if (age < 0 || age > 150) {
throw new IllegalArgumentException("Age out of range");
}
}
}
- compact constructor里不能调用
this(...)，也不能写return - 不要在里面赋值给组件名（如
email = email.trim()），record组件是final，编译不通过 - 如果真要预处理（比如trim），得靠带参构造器+显式委托，但那就不是标准record了
添加业务方法要注意返回值可变性
record方法常用来封装计算逻辑（如fullName()、isValid()），但容易忽略返回对象的可变性。一旦返回ArrayList、HashMap或用户自定义的非final类，外部修改会间接“污染”record状态，违背不可变设计初衷。
性能影响：频繁创建新集合（如每次调用都new ArrayList）可能触发GC压力，尤其在高吞吐场景。
- 返回集合时优先用
List.copyOf(list)（Java 10+）或Collections.unmodifiableList(...) - 避免在方法里缓存计算结果（如
private final String fullName;），record不允许私有字段 - 如果逻辑复杂、需缓存或依赖外部状态，说明这个类已超出record适用范围，该换成普通class
Record和Lombok @Data不兼容，别混用
有人想用Lombok简化record写法，比如加@Data或@Builder，结果编译失败或行为异常。因为Lombok的注解处理器和javac对record的处理逻辑冲突——@Data会尝试生成setter，而record没有setter；@Builder生成的builder类无法适配record的强制全参构造。
错误信息典型：cannot find symbol: method builder() 或 constructor User in class User cannot be applied to given types。
- record本身已提供不可变builder的等价能力：用静态工厂方法（如
public static User of(...)）替代 - 需要Builder模式？直接写一个独立的
UserBuilder类，不要用Lombok注解 - 已有Lombok项目想迁移到record，需手动移除相关注解，并验证所有测试用例（尤其是序列化、反射相关）
