如何用GSON将含嵌套列表的动态JWT Claims转为正确JSON对象

你使用的JWT库（比如JJWT）返回的Claims中的roles并非直接的Java List对象，而是库封装的Claim包装类，该类内部通过values属性存储实际的列表数据。Gson默认序列化时会完整输出这个包装类的结构，导致roles变成嵌套的{"values": [...]}格式，而非预期的数组。

方法1：手动转换Claims为原始Map #

遍历JWT返回的Claims，将每个Claim对象转换为实际对应的数据类型（比如列表、字符串等），存入新的Map后再序列化，直接避开包装类问题：

Map<String, Object> plainClaims = new HashMap<>();
for (Map.Entry<String, Claim> entry : jwt.getClaims().entrySet()) {
    String key = entry.getKey();
    Claim claim = entry.getValue();
    // 针对roles字段转换为字符串列表，其他字段直接取原始对象
    if ("roles".equals(key)) {
        plainClaims.put(key, claim.asList(String.class));
    } else {
        plainClaims.put(key, claim.asObject());
    }
}
// 序列化处理后的Map
String claimsMapInJsonString = new Gson().toJson(plainClaims);

方法2：自定义Gson序列化器处理Claim类型 #

编写一个Gson的序列化适配器，专门识别Claim类型并直接序列化其内部的实际值，而非包装类结构：

import com.google.gson.JsonElement;
import com.google.gson.JsonSerializationContext;
import com.google.gson.JsonSerializer;
import io.jsonwebtoken.Claim; // 根据你使用的JWT库调整导入路径
import java.lang.reflect.Type;

public class ClaimSerializer implements JsonSerializer<Claim> {
    @Override
    public JsonElement serialize(Claim claim, Type typeOfSrc, JsonSerializationContext context) {
        // 判断是否为列表类型，直接序列化内部的列表
        if (claim.isList()) {
            return context.serialize(claim.asList());
        }
        // 其他类型直接序列化原始对象
        return context.serialize(claim.asObject());
    }
}

注册该序列化器到Gson实例后再使用：

Gson gson = new GsonBuilder()
    .registerTypeAdapter(Claim.class, new ClaimSerializer())
    .create();
String claimsMapInJsonString = gson.toJson(jwt.getClaims(), new TypeToken<Map<String, Object>>(){}.getType());

方法3：直接获取JWT库的原始Claims Map #

部分JWT库提供了直接返回无包装的原始Claims映射的方法，比如JJWT的jwt.getBody()可能直接返回Map<String, Object>，如果你的库有类似API，直接序列化该对象即可：

String claimsMapInJsonString = new Gson().toJson(jwt.getBody());

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