如何在 Java 中通过反射修改 Record 字段值？答案是：无法安全实现

碧海醫心 2026-01-18 00:00:00 次阅读

java 的 record 类型本质上是不可变的，其字段被设计为 final 且禁止通过反射（如 `field.set()`）修改，即使调用 `setaccessible(true)` 也会抛出 `illegalaccessexception`。这是 jvm 层面的强制约束，而非限制疏漏。

Record 是 Java 14 引入的不可变数据载体类型，编译器会自动为每个组件字段生成 final 修饰符、私有不可变字段、公共访问器（getter）以及紧凑的构造逻辑。更重要的是，JVM 明确禁止对 record 类的字段执行反射写操作——这并非 Bug，而是语言规范的主动防护。

根据 JDK-8247517 官方说明，Field.set() 对 final 字段启用写权限的前提条件中，明确排除了 record 类型：

“the field's declaring class is not a record class”

这意味着以下代码注定失败：

Account account = new Account(null, null, null);
Field idField = Account.class.getDeclaredField("id");
idField.setAccessible(true);
idField.set(account, 42); // ❌ IllegalAccessException: Can not set final field...

✅ 正确替代方案

若需运行时动态赋值，请放弃 record，改用传统类（POJO），并手动控制字段可变性：

public class Account {
    private Integer id;
    private String login;
    private Boolean blocked;

    public Account(Integer id, String login, Boolean blocked) {
        this.id = id;
        this.login = login;
        this.blocked = blocked;
    }

    // 可选：提供 setter 以支持业务逻辑
    public void setId(Integer id) { this.id = id; }
    public void setLogin(String login) { this.login = login; }
    public void setBlocked(Boolean blocked) { this.blocked = blocked; }

    // 或保留 getter 仅读语义（推荐）
    public Integer getId() { return id; }
    public String getLogin() { return login; }
    public Boolean getBlocked() { return blocked; }

    @Override
    public String toString() {
        return "Account{id=" + id + ", login='" + login + "', blocked=" + blocked + '}';
    }
}

此时原反射方法 setFieldValue(...) 即可正常工作。