使用Gson反序列化JavaFX SimpleStringProperty对象遇反射异常求助

问题根源 #

你遇到的异常是因为Gson尝试通过反射访问javafx.beans.property.SimpleStringProperty的内部私有字段，但javafx.base模块没有将javafx.beans.property包开放给com.google.gson模块。你无法在自己的module-info.java中开放其他模块的包，所以之前添加opens javafx.beans.property to com.google.gson;会报错——这个包属于JavaFX的javafx.base模块，权限不在你的模块手中。

解决方案 #

方案1：自定义Gson TypeAdapter（推荐，符合模块化规范） #

通过自定义类型适配器，直接处理SimpleStringProperty的序列化/反序列化逻辑，绕过反射访问内部字段。

1. 编写SimpleStringProperty的TypeAdapter：

import com.google.gson.TypeAdapter;
import com.google.gson.stream.JsonReader;
import com.google.gson.stream.JsonWriter;
import javafx.beans.property.SimpleStringProperty;
import java.io.IOException;

public class SimpleStringPropertyTypeAdapter extends TypeAdapter<SimpleStringProperty> {
    @Override
    public void write(JsonWriter out, SimpleStringProperty value) throws IOException {
        // 序列化时写入属性的实际字符串值
        out.value(value.get());
    }

    @Override
    public SimpleStringProperty read(JsonReader in) throws IOException {
        // 反序列化时创建新的SimpleStringProperty实例
        return new SimpleStringProperty(in.nextString());
    }
}

2. 创建带适配器的Gson实例：

// 注册适配器到GsonBuilder
Gson gson = new GsonBuilder()
        .registerTypeAdapter(SimpleStringProperty.class, new SimpleStringPropertyTypeAdapter())
        .create();

// 使用该实例反序列化
Record record = gson.fromJson(lineStr, Record.class);

这种方法不需要修改模块配置或JVM参数，完全符合Java模块化的设计原则，稳定性更高。

方案2：添加JVM启动参数（临时调试用） #

如果需要快速验证功能，可以通过JVM参数强制让javafx.base模块将javafx.beans.property包开放给com.google.gson：

--add-opens javafx.base/javafx.beans.property=com.google.gson

• IDEA中设置：打开Run Configuration → VM options中添加上述参数
• 命令行运行：在java命令后添加该参数，例如：

java --add-opens javafx.base/javafx.beans.property=com.google.gson -jar your-app.jar

注意：这种方法属于临时 workaround，部署时需要确保启动参数正确，不符合模块化规范，不推荐长期使用。

额外注意事项 #

确保你的Record类的属性访问方法符合JavaFX规范：

public class Record {
    private final SimpleStringProperty uid = new SimpleStringProperty();
    private final SimpleStringProperty name = new SimpleStringProperty();
    private final SimpleStringProperty person = new SimpleStringProperty();

    // JavaFX属性访问器
    public SimpleStringProperty uidProperty() { return uid; }
    public SimpleStringProperty nameProperty() { return name; }
    public SimpleStringProperty personProperty() { return person; }

    // 常规getter/setter
    public String getUid() { return uid.get(); }
    public void setUid(String value) { uid.set(value); }

    public String getName() { return name.get(); }
    public void setName(String value) { name.set(value); }

    public String getPerson() { return person.get(); }
    public void setPerson(String value) { person.set(value); }
}

这样既保证JavaFX的属性绑定功能正常，也能让自定义TypeAdapter或Gson的默认逻辑正常工作。

内容的提问来源于stack exchange，提问作者HawkinHu