Java record 紧凑构造器怎样校验参数

Java record 的紧凑构造器适合把参数校验和轻量规范化集中在对象入口处。它省略了规范构造器的参数列表以及字段赋值，但并没有省略构造语义：构造体正常结束后，组件参数会被隐式写入对应字段。

因此，校验的核心写法是直接检查组件名，发现不满足约束就抛出异常；不要在紧凑构造器里重复写 this.name = name，也不要把它当成普通方法使用。

官方资料：https://docs.oracle.com/en/java/javase/25/language/records.html

先用一个 record 把校验放在入口

假设订单中需要一个正数金额和一个非空订单号。约束属于值对象本身，而不是某个调用方的临时判断，因此可以放进 record 的紧凑构造器：

// 订单值对象：在创建边界统一拒绝不合法状态
public record OrderAmount(String orderId, long cents) {
    // 参数名来自 record 组件，非法值通过异常阻止对象创建
    public OrderAmount {
        if (orderId == null || orderId.isBlank()) {
            throw new IllegalArgumentException("orderId 不能为空");
        }
        if (cents 

调用 new OrderAmount("A-1001", 2599) 时，构造器先执行检查；只要代码正常走到末尾，Java 才会把当前参数写入 orderId 和 cents。如果校验失败，异常会在对象创建处暴露，调用方不会拿到半成品对象。

紧凑构造器省略了什么

紧凑构造器的声明只有访问修饰符和 record 名称，没有显式参数列表：

// 显式规范构造器：参数列表和字段赋值都要自己维护
public record UserName(String value) {
    public UserName(String value) {
        if (value == null || value.isBlank()) {
            throw new IllegalArgumentException("value 不能为空");
        }
        // 规范构造器需要显式完成字段赋值
        this.value = value;
    }
}

// 紧凑构造器：参数列表和最终赋值由 record 语义补齐
public record CompactUserName(String value) {
    public CompactUserName {
        if (value == null || value.isBlank()) {
            throw new IllegalArgumentException("value 不能为空");
        }
    }
}

在紧凑构造器体内，value 指向隐式声明的构造参数，而不是直接指向字段。构造体结束后，隐式参数才会用于初始化 record 的私有组件字段。这正是它适合做校验的原因：校验发生在最终状态落地之前。

规范化参数时可以直接改组件名

校验是拒绝不合法输入，规范化则是把可接受但格式不统一的输入转换成统一值。例如订单号允许前后空格，但对象内部只保存去空格后的值：

// 规范化可接受输入，让 accessor 返回统一格式
public record NormalizedOrderId(String value) {
    public NormalizedOrderId {
        if (value == null) {
            throw new IllegalArgumentException("value 不能为 null");
        }
        // 重新赋值给隐式参数，末尾的隐式字段初始化会使用新值
        value = value.trim();
        if (value.isEmpty()) {
            throw new IllegalArgumentException("value 不能是空白字符串");
        }
    }
}

这里重新赋值的是参数变量，不是 record 字段。这样写的结果是 new NormalizedOrderId(" A-1001 ").value() 返回 "A-1001"。如果业务要求保留原始字符串，就不要在构造器里做这种规范化，而应保留原值并把清洗动作放到独立方法。

多字段校验要先明确规则边界

当约束涉及多个组件时，建议把基础校验和组合校验分开写，让异常信息对应明确的业务规则：

// 区间值对象：分别检查单字段，再检查字段之间的关系
public record PageRequest(int page, int size) {
    public PageRequest {
        // 页码和页大小是独立的基础约束
        if (page  100) {
            throw new IllegalArgumentException("size 必须在 1 到 100 之间");
        }
        // 组合约束放在基础约束之后，避免错误信息含义不清
        long offset = (long) (page - 1) * size;
        if (offset > Integer.MAX_VALUE) {
            throw new IllegalArgumentException("分页偏移量超出可接受范围");
        }
    }
}

构造器中的检查应保持短小。如果规则需要访问数据库、读取配置或调用远程服务，就已经超出值对象构造器的职责，应该在应用服务层完成，构造器只保留不依赖外部状态的稳定不变量。

这几种写法在紧凑构造器里不要混用

紧凑构造器还有几条语法边界：不能写显式的 return，不能调用另一个构造器，也不能直接给 record 的组件字段赋值。字段由 record 的构造语义负责初始化；如果需要完全控制参数列表、赋值或复制过程，应改用规范构造器。

一份可直接套用的完整模板

// 将格式校验、范围校验和规范化集中在值对象入口
public record ProductCode(String value, int quantity) {
    public ProductCode {
        if (value == null) {
            throw new IllegalArgumentException("value 不能为 null");
        }

        // 去除输入两端空白，后续字段会采用规范化后的参数
        value = value.trim().toUpperCase(java.util.Locale.ROOT);
        if (value.isEmpty()) {
            throw new IllegalArgumentException("value 不能为空");
        }
        if (quantity  9999) {
            throw new IllegalArgumentException("quantity 超出范围");
        }
    }
}

套用模板时先写清楚三个问题：哪些值必须拒绝，哪些值可以规范化，哪些检查必须交给外层服务。这样紧凑构造器只维护 record 的本地不变量，代码短但责任边界清楚。

常见问题

紧凑构造器里为什么不能写 this.value = value？

组件字段由 record 的隐式初始化逻辑负责赋值，紧凑构造器不能直接给组件字段赋值。需要完全手写赋值时，改用规范构造器。

重新给参数赋值会不会修改调用方对象？

重新赋值只改变构造器内部的参数变量，不会改动调用方传入的字符串对象；最终字段接收的是构造器结束时参数的值。

应该抛出哪一种异常？

对于调用方传入但不满足值域约束的参数，通常使用 IllegalArgumentException，并在消息中说明字段和规则。若规则依赖外部资源，建议在构造前返回领域层错误，而不是让构造器承担远程失败。

总结一下：紧凑构造器的最小配方是“检查组件参数，必要时规范化参数，正常结束后让 record 完成隐式字段初始化”。只要不重复写字段赋值、不混入外部依赖，record 就能保持不可变值对象的清晰边界。