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），并手动控制字段可变性：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

立即学习“Java免费学习笔记（深入）”；

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(...) 即可正常工作。

⚠️ 重要提醒

• 不要尝试绕过该限制（如字节码增强、Unsafe 操作等）：破坏 record 不可变性将导致语义混乱、线程安全风险及未来兼容性问题；
• record 的核心价值在于不可变性与透明性：适用于 DTO、返回值、函数式参数等场景；若需可变状态，请选用 class；
• 若需“构建后初始化”，可结合 Builder 模式或使用 record 配合静态工厂方法（但字段仍不可后期修改）。

总之：Record ≠ 可变 POJO。选择 record，即承诺不可变；需要反射赋值？请回归标准类设计。