如何通过字符串类名获取Gson的TypeToken实现泛型反序列化？

算力阿峰

2026-5-15

当然可行！这其实是Gson动态泛型反序列化的常见场景——当泛型类型只能在运行时通过字符串类名获取时，我们可以通过反射+动态构造泛型Type来解决。我给你一步步拆解具体实现：

核心思路

我们需要先把字符串类名转换成对应的Class对象，再手动构造出ActionTask<X>对应的泛型Type（而不是编译时确定的TypeToken），最后传给Gson完成反序列化。

具体实现步骤

1. 将字符串类名转为Class对象

首先用Class.forName()方法把全限定类名字符串转换成Class实例，注意要处理ClassNotFoundException（比如类名写错、类不在类路径中）：

String className = "com.example.UptimeAction"; // 这里要写全限定类名
Class<?> actionClass = Class.forName(className);

2. 构造泛型Type

这里有两种靠谱的方式，选一种就行：

方式一：用Gson自带工具（推荐，Gson 2.8.0+）

Gson从2.8.0版本开始提供了TypeToken.getParameterized()静态方法，可以直接帮我们构造泛型Type，不用自己写类：

Type type = TypeToken.getParameterized(ActionTask.class, actionClass).getType();

方式二：自定义ParameterizedType实现（兼容旧版Gson）

如果你的Gson版本比较老，没有上面的静态方法，可以自己实现ParameterizedType接口来构造泛型Type：

public class GenericType implements ParameterizedType {
    private final Class<?> rawType;
    private final Type[] actualTypeArguments;

    public GenericType(Class<?> rawType, Type... actualTypeArguments) {
        this.rawType = rawType;
        this.actualTypeArguments = actualTypeArguments;
    }

    @Override
    public Type[] getActualTypeArguments() {
        return actualTypeArguments;
    }

    @Override
    public Type getRawType() {
        return rawType;
    }

    @Override
    public Type getOwnerType() {
        return null; // 大部分场景下返回null即可
    }
}

然后构造Type：

Type type = new GenericType(ActionTask.class, actionClass);

3. 执行反序列化

拿到Type之后，就和你原来的代码一样调用fromJson()了，因为泛型是动态的，用通配符?接收更安全，之后可以根据需要做类型检查和强转：

Gson gson = new Gson();
ActionTask<?> task = gson.fromJson(json, type);

// 类型安全的强转（避免ClassCastException）
if (task.getData() instanceof UptimeAction) {
    UptimeAction action = (UptimeAction) task.getData();
    // 这里处理你的业务逻辑
}

注意事项

字符串类名必须是全限定类名（比如com.example.UptimeAction），如果是同包下的类可以省略包名，但推荐用全限定名避免类查找失败。
一定要处理ClassNotFoundException，比如用户输入的类名错误、类没有被正确打包到项目中。
动态泛型反序列化后，尽量用instanceof做类型检查再强转，避免运行时类型转换异常。

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