Record 是 Java 14 引入、16 正式发布的不可变数据载体语法糖，自动生成构造器、final 字段、getter、equals、hashCode 和 toString，专为 DTO 场景设计，替代手写或 Lombok 方案。
Record 是什么，它为什么能替代手写 DTO
Record 是 Java 14 引入、Java 16 正式成为正式特性的语法糖，本质是为“不可变数据载体”提供简洁声明方式。它不是类的子集，而是一种受限的类形式：编译器自动生成构造器、字段（
）、getter、
、
和
—— 这正是 DTO 最需要的契约。
你不需要手动写
加一堆样板方法，也不用依赖 Lombok 的
或
；Record 从语言层保证了不可变性与结构一致性。
注意：
声明的类型默认
，不能被继承，所有字段隐式
，且只能通过构造器初始化。
怎么写一个带验证逻辑的 Record
纯 Record 不支持在构造器里做参数校验（比如
），因为它的构造器由编译器生成，无法直接重写。但你可以用“紧凑构造器”（compact constructor）来插入校验逻辑：
立即学习
“
Java免费学习笔记（深入）
”；
关键点：
Eclipse导入Android或其他的JAVA项目的正确方法 WORD版
本文档主要讲述的是Eclipse导入Android或其他的JAVA项目的正确方法；希望本文档会给有需要的朋友带来帮助；感兴趣的朋友可以过来看看
下载
紧凑构造器没有参数列表、没有
、不调用
，它会在编译器生成的隐式构造器体内部执行
它能访问所有组件名（
,
），但此时字段尚未赋值，所以可安全校验原始参数
若抛出异常，实例不会被创建，符合预期
不要在紧凑构造器里给组件赋值（如
）——这会破坏 record 的规范语义，编译器会报错
Record 和普通类在 equals/hashCode 上的行为差异
Record 的
和
是基于
组件值
（即声明的字段）逐个比较的，不关心字段顺序以外的任何东西。例如：
常见陷阱：
Record 的
不会递归比较嵌套对象的深层内容 —— 如果字段是另一个 Record，那没问题（因为那个 Record 也实现了合理
）；但如果字段是
或自定义类，就得确保该类型自身有正确实现
Record 的
是各组件
的结果，所以如果某个组件是
，它会被当作
参与计算 —— 这和
行为一致，但容易被忽略
不要试图 override
或
：虽然语法允许，但会破坏 record 的语义契约，IDE 通常会警告，且可能导致序列化、集合操作等行为异常
Record 在 JSON 序列化和 ORM 中的实际使用限制
Jackson（2.12+）原生支持 Record，但需启用
并注册：
但注意：
JPA/Hibernate **不支持 Record 作为实体（@Entity）** —— 因为实体必须可变、有无参构造器、支持代理，而 Record 全部违反
Record 可以作为 DTO 被
接收（Spring Boot 2.6+ 默认支持），但若字段名与 JSON key 不一致，仍需
显式标注
Record 的组件名就是字段名，也是 JSON key，默认驼峰转下划线需靠
配置，不是自动的
避免把 Record 当作 Builder 使用：它没有 wither 方法，也没有 builder 模式支持；需要派生新实例时，得手动 new —— 比如
Record 真正省力的地方在于“定义即契约”，但它的刚性也意味着：一旦字段语义或约束变化，你就得改类型本身，而不是只改 getter 逻辑。这点比传统类更严格，也更清晰。
finalequals()hashCode()toString()public final String name@Value@DatarecordfinalfinalObjects.requireNonNull(name)
record User(String name, Integer age) {
public User {
if (name == null || name.trim().isEmpty()) {
throw new IllegalArgumentException("name must not be blank");
}
if (age == null || age < 0 || age > 150) {
throw new IllegalArgumentException("age must be between 0 and 150");
}
}
}
returnsuper()nameagethis.name = name.trim()equals()hashCode()
record Point(int x, int y) {}
record Point2(int y, int x) {} // 组件名和顺序不同 → 类型不同，equals 不可能为 true
equals()equalsListhashCode()Objects.hash(...)null0Objects.hash()equalshashCodeParameterNamesModule
ObjectMapper mapper = new ObjectMapper();
mapper.registerModule(new ParameterNamesModule());
// 然后就能直接 writeValueAsString(new User("Alice", 30))
@RequestBody@JsonPropertyPropertyNamingStrategies.LOWER_CAMEL_CASEnew User(u.name(), 25)