Moshi解析JSON返回可空对象的原因及异常处理咨询

嘿，刚接触Kotlin和Moshi很正常，我当初上手的时候也纠结过这些点，咱们一个个来解决～

一、为什么fromJson返回可空对象，必须用!!或?.调用？ #

这其实是Moshi本身的API设计决定的：Moshi的fromJson方法签名就是fun <T> fromJson(reader: JsonReader): T?，它天生返回可空类型。

原因很简单——解析JSON的过程充满不确定性：哪怕你定义的数据类字段都是必填的，也可能遇到JSON格式错误、字段类型不匹配、甚至IO异常等情况。Moshi为了避免未捕获的异常直接导致崩溃，把返回值设计成可空，让开发者主动处理解析失败的场景。

哪怕你的JSON完全符合数据类的结构，解析成功后返回的依然是T?类型，所以必须用?.安全调用或者!!非空断言（但后者要谨慎，万一解析失败返回null会直接抛出NPE）。

二、如何让解析无效JSON时返回null而不是抛出异常？ #

默认情况下，Moshi遇到缺失必填字段、格式错误等问题时会直接抛出异常，但我们可以通过添加容错适配器来让它返回null，具体步骤如下：

方法：使用NullOnFailureJsonAdapter #

这个适配器是Moshi官方提供的容错工具，它会捕获解析过程中所有的异常，然后返回null代替抛出异常。

1. 首先确保你的依赖里包含Moshi的适配器模块（以Gradle为例）：

implementation("com.squareup.moshi:moshi-kotlin:1.14.0") // 替换成你使用的版本
implementation("com.squareup.moshi:moshi-adapters:1.14.0")

2. 创建Moshi实例时添加这个适配器工厂：

import com.squareup.moshi.Moshi
import com.squareup.moshi.adapters.NullOnFailureJsonAdapter

val moshi = Moshi.Builder()
    .add(NullOnFailureJsonAdapter.FACTORY)
    .build()

// 生成对应数据类的适配器
val adapter = moshi.adapter(InitialAppResult::class.java)

// 现在解析失败会返回null，而不是抛出异常
val result: InitialAppResult? = adapter.fromJson(yourJsonString)

补充：其他可选方案 #

如果你只是想处理缺失必填字段的情况，也可以给数据类字段设置默认值，这样Moshi会用默认值初始化缺失的字段，不会抛出异常：

data class InitialAppResult(
    val status: Int = -1,
    val message: String = "",
    val baseprm: String = ""
)

不过这种方案和返回null的逻辑不同——它会生成一个带默认值的对象，而不是null，你可以根据业务需求选择。

注意事项 #

• 尽量避免用!!非空断言，哪怕你觉得JSON一定合法，也可能有意外情况。推荐用?.let处理非空场景，用?:处理null的情况：

adapter.fromJson(yourJsonString)?.let { result ->
    // 解析成功，处理result
} ?: run {
    // 解析失败返回null，处理错误逻辑
}

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