Android插桩测试中Gson序列化字段自动按字母排序如何解决

Gson默认序列化POJO时，字段的遍历顺序直接依赖JVM/ART虚拟机对Class.getDeclaredFields()方法的返回结果，该方法的返回顺序没有任何官方规范做统一约定：

• 桌面端标准JVM（单元测试运行环境）通常按字段在源码中的声明顺序返回结果，因此输出顺序为a → c → b
• Android平台的ART/Dalvik虚拟机（插桩测试运行环境）默认按字段名的字典序排序返回，因此输出顺序为a → b → c
  未显式指定序列化顺序时，跨环境出现顺序差异是必然结果。

按稳定性和实现成本排序，推荐以下两种方案：

方案1：为目标类注册自定义TypeAdapter（最稳妥，零兼容问题） #

手动实现TestInfo类的序列化/反序列化逻辑，完全控制字段输出顺序，不受虚拟机实现、混淆配置影响，所有平台运行结果完全一致。

1. 编写自定义TypeAdapter：

   public class TestInfoAdapter extends TypeAdapter<Test.TestInfo> {
       @Override
       public void write(JsonWriter out, Test.TestInfo value) throws IOException {
           out.beginObject();
           // 严格按照期望的声明顺序写入字段
           out.name("a").value(value.a);
           out.name("c").value(value.c);
           out.name("b").value(value.b);
           out.endObject();
       }
   
       @Override
       public Test.TestInfo read(JsonReader in) throws IOException {
           Test.TestInfo instance = new Test.TestInfo();
           in.beginObject();
           while (in.hasNext()) {
               String fieldName = in.nextName();
               switch (fieldName) {
                   case "a":
                       instance.a = in.nextInt();
                       break;
                   case "c":
                       instance.c = in.nextInt();
                       break;
                   case "b":
                       instance.b = in.nextInt();
                       break;
                   default:
                       in.skipValue(); // 忽略未知字段，避免解析崩溃
               }
           }
           in.endObject();
           return instance;
       }
   }
   

2. 构建Gson实例时注册该适配器：

   Gson gson = new GsonBuilder()
           .setPrettyPrinting()
           .serializeNulls()
           .registerTypeAdapter(Test.TestInfo.class, new TestInfoAdapter())
           .create();
   

方案2：自定义顺序注解+通用适配器（适合多实体类统一管控） #

如果需要固定顺序的实体类较多，可以自定义顺序注解实现全局通用的排序逻辑，避免为每个类单独写Adapter：

1. 定义序列化顺序注解：

   @Retention(RetentionPolicy.RUNTIME)
   @Target(ElementType.FIELD)
   public @interface SerializeOrder {
       int value();
   }
   

2. 在实体类字段上标记顺序，和源码声明顺序保持一致：

   public static class TestInfo {
       @SerializeOrder(1)
       public int a;
       @SerializeOrder(2)
       public int c;
       @SerializeOrder(3)
       public int b;
   
       // 原有构造方法逻辑不变
   }
   

3. 实现通用的反射TypeAdapterFactory，获取字段列表后按注解标记的顺序排序，再交给Gson默认的反射序列化逻辑处理即可。

• 不要尝试依赖高版本Android的虚拟机实现“默认按声明顺序返回字段”的特性：Android 8.0（API 26）以下的ART、所有版本的Dalvik都不保证该行为，低版本设备上依然会出现顺序错乱
• 开启R8/ProGuard混淆时，需要给序列化实体类添加keep规则，避免字段被移除、重命名或重排：

  # 替换成你自己的实体类全路径
  -keep class your.package.name.Test$TestInfo { *; }
  

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