Record 应仅用于纯粹不可变数据载体：无行为、全字段公开且不可变、不继承、不重写equals/hashCode/toString；误用于需懒加载、格式化或扩展的DTO等场景将增加维护成本。
Record 类不是“更轻量的 class”，而是明确放弃可变性的数据载体——用错场景反而增加维护成本。
什么时候该用 record 而不是普通 class
只在你确定这个类型满足全部以下条件时才用 record：
- 仅用于携带数据，不封装行为（比如没有
save()、validate()这类方法） - 所有字段都应被公开且不可变（
final语义已由 record 强制保证） - 不需要继承其他类（
record隐式继承java.lang.Record，不能再 extends） - 不打算重写
equals()/hashCode()/toString()的逻辑（record 自动生成的版本是基于所有组件字段的）
常见误用：把 DTO、VO、API 响应体直接全换成 record，结果发现某个字段需要懒加载或格式化输出，又得退回去改 class + 手动补构造器和 toString。
record 的构造器和字段访问有隐含规则
声明 record Person(String name, int age) 后，编译器会生成：
- 一个 public 的全参构造器（不能删，也不能加
private修饰） - 两个 public 的访问器方法：
name()和age()（不是getName()！注意命名差异） - 隐式
final字段，不可在构造器外赋值
如果你想校验参数（比如 age >= 0），只能靠紧凑构造器（compact constructor）：
record Person(String name, int age) {
// 紧凑构造器，自动调用全参构造器前执行
public Person {
if (age <p>注意：这里不能写 <code>this.age = Math.max(0, age)</code> —— 紧凑构造器里不允许给组件字段赋值，只能做检查或抛异常。</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill12540" title="javascript-typescript-typescript-scaffold"><img
src="https://img.php.cn/upload/skill/001/246/273/6adaf20e352aa140.jpg" alt="javascript-typescript-typescript-scaffold" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/skill12540" title="javascript-typescript-typescript-scaffold" class="overflowclass">javascript-typescript-typescript-scaffold</a>
<p class="overflowclass">你是 TypeScript 项目架构专家，专注于脚手架搭建生产就绪的 Node.js 和前端应用。生成包含现代工具链（pnpm、Vite、Next.js）、类型</p>
</div>
<a rel="nofollow" href="/xiazai/skill12540" title="javascript-typescript-typescript-scaffold" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div><h3>泛型、注解和序列化要注意兼容性</h3><p><code>record</code> 支持泛型和注解，但部分框架对它的反射支持仍滞后：</p>
- Jackson 2.12+ 默认能序列化/反序列化
record，但若字段加了@JsonProperty("full_name")，必须加在 构造器参数上，而不是字段（因为没字段声明） - Lombok 的
@Data和@Builder与record冲突，不能混用；想用 builder 模式得手写静态工厂方法或配合record的紧凑构造器 - Spring Boot 2.6+ 对
@RequestBody中的record支持良好，但早期版本可能报No default constructor错误（因误判为普通 class）
示例：带注解的 record 反序列化写法
record User(@JsonProperty("user_id") Long id, String username) {}
别忽略 record 的局限性：无法实现接口中的默认方法重写
虽然 record 可以 implements 接口，但如果接口里有默认方法，你不能在 record 里覆盖它（语法禁止）。例如：
interface Identifiable { Long getId(); default String key() { return "id:" + getId(); } }
record Product(Long id, String name) implements Identifiable { // ✅ 编译通过
public Long getId() { return id; }
// ❌ 不能写：public String key() { return "prod:" + id; }
}
此时若需要定制 key()，只能放弃 record，改用 class。这是最容易被忽略的设计断点——看起来只是少写几行代码，实则锁死了后期扩展路径。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
