使用Retrofit时是否需要使用Scalers Converter?
问题解答
ScalarConverterFactory的使用必要性拆解
首先要明确一个容易被混淆的边界:ScalarConverterFactory是Retrofit生态下的专用转换器组件,它的能力和Moshi、kotlinx.serialization这类JSON库本身的解析能力完全不在同一个层级。
- 仅当你的后端返回非标准JSON格式的裸值/纯文本响应时,搭配ScalarConverterFactory才有实际意义:比如接口直接返回不带双引号的
success字符串、不带任何JSON包装的纯数字状态码,这类响应不符合JSON解析规范,Moshi、kotlinx.serialization根本无法正常解析,这时候用ScalarConverterFactory直接读取原始响应体匹配返回值,是有实际价值的。 - 如果你的接口返回的是完全符合JSON规范的基本类型值(比如带双引号的JSON字符串
"hello"、JSON格式的数字123、JSON布尔值true),那完全没有额外引入ScalarConverterFactory的必要,甚至加了之后反而可能引发解析冲突——Retrofit会按照添加顺序匹配Converter,ScalarConverterFactory优先级更高的话,会直接拦截所有String、基本类型的返回值请求,跳过JSON解析逻辑,把原始响应文本直接赋值给返回值;如果你的响应本身是符合JSON规范的带转义的字符串,比如"hello\"world",被拦截后你拿到的会是带双引号和转义符的原始文本,而不是解码后的实际字符串值,完全不符合预期。
Moshi的基本类型反序列化能力
Moshi从设计上就原生覆盖了所有JSON基本类型的反序列化场景,完全不需要额外适配:
- 开箱支持JSON字符串到Kotlin
String、JSON数字到Kotlin 各数值类型(Int/Long/Float/Double)、JSON布尔值到KotlinBoolean的映射 - 不需要自定义适配器、不需要额外第三方依赖,直接通过Moshi内置的适配逻辑就能完成解析,比如手动构建Moshi实例获取对应类型的适配器,即可直接解析合法的JSON基本类型片段,不存在“解析不了裸基本类型”的问题。
kotlinx.serialization的基本类型反序列化能力
kotlinx.serialization的核心JSON实现同样把基本类型的支持作为内置能力,没有任何使用门槛:
- 只要引入核心的
kotlinx-serialization-json依赖,不需要额外插件、不需要配置自定义序列化器 - 可直接通过
Json.decodeFromString<String>("\"test\"")、Json.decodeFromString<Int>("12")这类标准API,完成所有对应JSON基本类型的反序列化,能力完全覆盖常规开发场景。
内容的提问来源于stack exchange,提问作者Heybradharris
相关产品推荐
相关产品推荐

