需要注意两点：

• 当前项目必须要有 Kotlin 环境，否则会编译不通过

• Gson 框架必须使用 2.9.0 及以上版本，否则将会出现版本兼容问题

目前支持容错的数据类型有：

• Bean 类

• 数组集合

• Map 集合

• JSONArray

• JSONObject

• String（字符串）

• boolean / Boolean（布尔值）

• int / Integer（整数，属于数值类）

• long / Long（长整数，属于数值类）

• float / Float（单精度浮点数，属于数值类）

• double / Double（双精度浮点数，属于数值类）

• BigDecimal（精度更高的浮点数，属于数值类）

基本涵盖 99.99% 的开发场景，可以运行 Demo 中的单元测试用例来查看效果：

大家可能觉得 Gson 解析容错没什么，那是因为我们对 Gson 解析失败的场景没有了解过：

• 惊吓不断：后台有数据时返回 JsonObject 类型，没数据返回 []，Gson 会直接抛出异常

• 意想不到：如果客户端定义的是 boolean 类型，但是后台返回的是 0 或者 1，Gson 会直接抛出异常

• 措手不及：如果客户端定义的是 int 或者 long 类型，但是后台返回的是 float 或者 double 类型，Gson 会直接抛出异常

以上情况框架已经做了容错处理，具体处理的规则如下：

• 如果后台返回的类型和客户端定义的类型不匹配，框架就跳过解析这个字段，不影响其他字段正常解析

• 如果客户端定义的是 boolean 类型，但是后台返回整数，框架则将非 0 的数值则赋值为 true，否则为 false

• 如果客户端定义的是 int 或者 long 类型，但后台返回浮点数，框架就对数值进行直接取整并赋值给字段

大家是不是以为在后台返回 { "age" : null }，age 字段的值会等于 18 ？我帮大家测试过了，不会等于 18，会等于空。

那么这到底是为什么呢？聊到这个就不得不先说一下 Gson 解析的机制，我们都知道 Gson 在解析一个 Bean 类的时候，会反射创建一个对象出来，但是大家不知道的是，Gson 会根据 Bean 类的字段名去解析 Json 串中对应的值，然后简单粗暴进行反射赋值，你没有听错，简单粗暴，如果后台返回这个 age 字段的值为空，那么 age 就会被赋值为空，但是你又在 Kotlin 中声明了 age 变量不为空，外层一调用，触发 NullPointerException 也是在预料之中。

另外针对 List 和 Map 类型的对象，后台如果有返回 null 或者错误类型数据的时候，框架也会返回一个不为空但是集合大小为 0 的 List 对象或者 Map 对象，避免在 kotlin 字段上面自定义字段不为空，但是后台返回空的情况导致出现的空指针异常。

框架目前的处理方案是，如果后台没有返回这个字段的值，又或者返回这个值为空，则不会赋值给类的字段，因为 Gson 那样做是不合理的，会导致我在 Kotlin 上面使用 Gson 是有问题，变量不定义成可空，每次用基本数据类型还得去做判空，定义成非空，一用还会触发 NullPointerException，前后夹击，腹背受敌。

如果丢给原生 Gson 解析，无论 Json 是什么值，最终会得到 name 的字段值是空的，而丢给 moshi 解析，则会抛出空指针异常，而 GsonFactory 却能正常解析成 ""，为什么三个框架有三种不同的结果，这是因为三种框架反射 kotlin data class 类不同实现方式导致的，具体看下面的介绍

Gson：只会反射空参构造函数，即使某个类不存在空参构造函数，也不会反射失败，这是因为 Gson 内部采用了一种特殊的方式来实例化 Class（即使用 sun.misc.Unsafe 类的 allocateInstance(Class<?> clazz) 方法来创建对象，需要注意的是这个方法是被 native 修饰的），所以对象虽然勉强被创建成功了，但是类里面的字段并没有进行初始化，这是 Unsafe 类在创建对象的时候绕过了构造函数进行创建（具体它是怎么做到的，这个不是我们要研究的重点），所以为什么 kotlin data class 类型的字段会为空，原因就在这里。

moshi：而 moshi 用到的方案更加聪明了，它依赖了一个 kotlin 反射库，反射 kotlin data class 类的时候，它找到 kotlin data class 的主构造函数，然后进行反射创建，moshi 之所以这么做，是因为这样反射可以保留 kotlin data class 类字段上面的默认值，但是存在一个致命的问题，像 (var name: String) 这种字段是没有默认值的，但是它又没有被标记是可空的，会导致 kotlin 在编译 kotlin data class 类的时候，会对 name 字段例行非空检查（如果为空则抛出 NullPointerException 异常），所以使用此框架的人需要将代码写法修改成这样 (var name: String = "")，否则编译过程不报错，但是一使用 moshi 解析就会报错，我一直认为在 kotlin 类定义 (var name: String) 字段是错误的，你既然没有标记为可空的，那么就应该给它赋值，如果不给它赋值，则应该给它标记为可空的，即 (var name: String?)，但是令人奇怪的是，明明这样的写法是错误的，kotlin 语法在检查的时候，还是让它编译通过了，希望 kotlin 官方后续能纠正这一个问题吧。

GsonFactory：在 moshi 框架的基础上进行了改良，即上面提到的一个问题，对一些被定义成非空并且没有被赋值的字段，GsonFactory 会给这些字段赋一个默认值，如果这个字段是基本数据类型，就直接赋值成基本数据类型的默认值，如果是对象类型，则反射创建对象，当然 kotlin data class 类型的字段也不例外，会反射创建一个 kotlin data class 类型的对象赋值到字段上面，这样不会出现一解析报 NullPointerException 异常了。

如果你们的后台用的是 PHP，那我十分推荐你使用这个框架，因为 PHP 返回的数据结构很乱，这块经历过的人都懂，说多了都是泪，没经历过的人怎么说都不懂。

如果你们的后台用的是 Java，那么可以根据实际情况而定，可用可不用，但是最好用，作为一种兜底方案，这样就能防止后台突然某一天不讲码德，例如我现在的公司的后台全是用 Java 开发的，但是 Bugly 还是有上报关于 Gson 解析的异常，下面是通过 GsonFactory.setParseExceptionCallback 采集到的数据，大家可以参考参考：

粗略估算了一下，总共上报了三千万多次错误，影响设备数三百多万，看到这里你还相信 Java 开发的后台不会有数据容错的问题么？事在人为，Java 只是一种开发语言，并不能担保不会有数据容错的问题，如果后续真的出现了这种问题，主要分为两种情况：

• 如果 iOS 没有做数据容错，那么锅是后台的，这点是毫无疑问的，后台想甩也甩不开

• 如果 iOS 做了数据容错，那么很可能的处理结果是，后台和 Android 两端的人要被拉出去各挨五十大板：

  • CTO：后台有问题，为什么 iOS 没事，就 Android 有事？

  • Android：iOS 那边做了容错，但是 Android 这边没有做。

  • CTO：你们为什么不做？这种兜底机制本来不应该就得有的吗？

  • Android：我们用了 Gson 框架，它的机制本身就是这样的。

  • CTO：我不管你们用了什么框架，在这点上崩溃了就是你们不对，后台返回错误的数据结构你们不解析就好了，你为什么还崩溃？同样的数据结构咋 iOS 就没有事呢？这个责任应该有你们 Android 一份子。

  • Android：。。。。。。（哑巴吃黄连，有苦说不出）

  • Ps：以上故事纯属虚构，大家看看就好，切勿太过当真。不过有一点是真的，若不想日后扯皮，最好还是要留一手。

安卓技术中台：AndroidProject

安卓技术中台 Kt 版：AndroidProject-Kotlin

权限框架：XXPermissions

吐司框架：Toaster

网络框架：EasyHttp

标题栏框架：TitleBar

悬浮窗框架：EasyWindow

ShapeView 框架：ShapeView

ShapeDrawable 框架：ShapeDrawable

语种切换框架：MultiLanguages

日志查看框架：Logcat

嵌套滚动布局框架：NestedScrollLayout

Android 版本适配：AndroidVersionAdapter

Android 代码规范：AndroidCodeStandard

Android 资源大汇总：AndroidIndex

Android 开源排行榜：AndroidGithubBoss

Studio 精品插件：StudioPlugins

表情包大集合：EmojiPackage

AI 资源大汇总：AiIndex

省市区 Json 数据：ProvinceJson

Markdown 语法文档：MarkdownDoc