record 必须至少声明一个字段,不可继承或被继承,自动实现基于字段值的 equals/hashcode/tostring,字段隐式 final,支持自定义构造器但须调用 canonical 构造器。

Record 类必须有至少一个字段
Java 的 record 不是普通类的语法糖,它本质是不可变的数据载体,编译器会强制你声明至少一个组件字段。如果写成 record EmptyRecord {},javac 直接报错:error: record must declare at least one component。
常见误用是想定义一个“标记型 record”来替代枚举或空接口,这行不通。真需要语义标记,用 enum 或 interface;真要空数据结构,老实用 class。
- 字段名不能是
final、static、transient等修饰符(编译器自动加final) - 字段类型可以是任意引用或基本类型,但建议避开可变类型(如
ArrayList),否则破坏“不可变”契约 - 构造函数参数顺序和字段声明顺序严格一致,不能重排
自定义构造函数时必须调用 canonical 构造器
record 允许定义额外构造器,但所有自定义构造器第一行必须显式调用 this(...),且参数必须能映射到 record 声明的字段。比如:
record Point(int x, int y) {
public Point(int x) {
this(x, 0); // ✅ 正确:转发给 canonical 构造器
}
public Point() {
this(0, 0); // ✅ 同样合法
}
}
如果漏掉 this(...) 或调用普通方法,编译失败:error: call to super() or this() must be first statement。
立即学习“Java免费学习笔记(深入)”;
- 不能在自定义构造器里对字段赋值(
this.x = ...非法),字段由 canonical 构造器统一初始化 - 如果字段有校验逻辑(如非负),只能放在 canonical 构造器里,用
private构造器 +this(...)转发实现 - IDE 自动生成的构造器补全通常不处理 record,别依赖它
record 的 equals/hashCode 是基于字段值,不是引用
record 自动重写 equals()、hashCode() 和 toString(),全部基于组件字段的值。这意味着两个不同实例只要字段值相同,equals 就返回 true —— 这和 String 行为一致,但和普通 class 默认行为完全不同。
容易踩的坑是把 record 当作“轻量 class”随意修改字段,结果发现 Set 里存了重复项,或者作为 Map key 时行为异常。因为 record 字段是 final,你改不了;但如果你字段里存了可变对象(比如 List<string></string>),外部修改这个 list,hashCode() 结果就可能变,违反哈希契约。
- record 实例放进
HashSet后,不要让它的任何字段指向的对象发生内容变更 - 字段类型优先选不可变类(
String、LocalDate、其他 record),避免ArrayList、HashMap - 如果必须用可变集合,考虑在构造时做防御性拷贝:
new ArrayList(inputList)
record 不能继承,也不能被继承
record 是 final 类,隐式 final,所以不能用 extends 继承其他类,也不能被其他类 extends。试图写 record A extends B 或 class C extends MyRecord,编译器直接拒绝:error: records are implicitly final and cannot extend other classes。
有人想用 record 模拟 DTO 继承结构(比如 UserRecord 和 AdminRecord 共享字段),这条路走不通。替代方案只有两个:
- 用组合:让
AdminRecord包含一个UserRecord字段 - 放弃 record,退回普通
class,自己手写equals/hashCode(或用 Lombok@Data) - Java 16+ 支持
sealed类配合 record,但 record 本身仍不能作为父类
record 的设计哲学就是“扁平、明确、不可扩展”,想搞层次结构,它就不是合适工具。









