Java使用Gson构造JsonObject时添加String列表报无法转换为JsonElement错误

Gson 中 JsonObject#add(String key, JsonElement value) 方法的第二个入参，要求必须是 JsonElement 类型的实例。Java 原生 List 不属于 Gson 的类型体系，无法直接传入该方法，因此触发编译报错。

类型对应关系：JSON 结构中的键值对对象对应 JsonObject，顺序列表对应 JsonArray，二者都是 JsonElement 的子类，不能混用。

• 方案1：手动将List转换为JsonArray逐层构造
  先将List内的元素逐个加入JsonArray实例，再按照目标JSON的层级关系嵌套JsonObject即可：

  import com.google.gson.JsonArray;
  import com.google.gson.JsonObject;
  import java.util.ArrayList;
  import java.util.List;
  
  List<String> arr = new ArrayList<>();
  arr.add("f");
  arr.add("g");
  arr.add("h");
  
  // 构造匹配e值的数组结构
  JsonArray eArray = new JsonArray();
  arr.forEach(eArray::add);
  
  // 按层级嵌套对象
  JsonObject dLevel = new JsonObject();
  dLevel.add("e", eArray);
  
  JsonObject cLevel = new JsonObject();
  cLevel.add("d", dLevel);
  
  JsonObject root = new JsonObject();
  root.addProperty("a", "b");
  root.add("c", cLevel);
  

• 方案2：借助Gson内置序列化能力直接转换
  无需手动遍历转换，通过Gson#toJsonTree方法可以直接将任意Java对象（包括List）转为对应的JsonElement实例，简化代码：

  import com.google.gson.Gson;
  import com.google.gson.JsonObject;
  import java.util.ArrayList;
  import java.util.List;
  
  List<String> arr = new ArrayList<>();
  arr.add("f");
  arr.add("g");
  arr.add("h");
  
  JsonObject dLevel = new JsonObject();
  // 直接将List转为符合类型要求的JsonElement
  dLevel.add("e", new Gson().toJsonTree(arr));
  
  JsonObject cLevel = new JsonObject();
  cLevel.add("d", dLevel);
  
  JsonObject root = new JsonObject();
  root.addProperty("a", "b");
  root.add("c", cLevel);
  

实用提示：构造字符串、数值等基础类型的键值对时，可直接使用JsonObject#addProperty方法，无需手动包装JsonPrimitive，提升代码简洁度。

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