Android使用Retrofit与Gson解析Date类型字段出现时区报错问题咨询
错误根因
Gson内置的默认Date解析逻辑仅兼容ISO8601标准日期格式(格式中日期和时间部分用T作为分隔符,比如2021-05-03T18:01:42+08:00)。当后端返回的日期字符串用空格作为日期与时间的分隔符(即2021-05-03 18:01:42这种yyyy-MM-dd HH:mm:ss格式)时,默认解析器会把空格误判为非法的时区标识,最终触发JsonSyntaxException。
可落地解决方案
根据项目实际的字段格式约定,可选择以下两种实现方式:
方案1:全局统一配置Gson日期解析规则
如果项目内所有Date类型字段都和后端约定使用yyyy-MM-dd HH:mm:ss格式,直接在初始化Retrofit时配置Gson的全局日期格式即可,无需修改现有实体类代码:
// 初始化匹配后端格式的Gson实例 val gson = GsonBuilder() // 直接指定全局Date字段的解析/序列化格式 .setDateFormat("yyyy-MM-dd HH:mm:ss") .create() // 将自定义Gson实例传入Retrofit的转换器 val retrofit = Retrofit.Builder() .baseUrl("你的项目接口根地址") .addConverterFactory(GsonConverterFactory.create(gson)) // 其余Retrofit原有配置项保持不变 .build()
方案2:单字段适配解析规则
如果项目内只有部分字段是上述日期格式,其余字段需要使用Gson默认解析规则,可通过@JsonAdapter注解单独绑定解析逻辑,不影响其他字段的解析流程:
// 实体类代码 class Order { // 为单个createTime字段绑定专用日期解析适配器 @JsonAdapter(BackendDateAdapter::class) var createTime: Date? = null } // 单字段专用的日期解析适配器 class BackendDateAdapter : TypeAdapter<Date?>() { // 初始化解析格式,指定Locale避免跟随系统语言出现解析偏差 private val dateFormat = SimpleDateFormat("yyyy-MM-dd HH:mm:ss", Locale.getDefault()) override fun write(out: JsonWriter, value: Date?) { out.value(value?.let { dateFormat.format(it) }) } override fun read(input: JsonReader): Date? { val dateStr = input.nextString() // 解析失败时返回null,不阻断整体响应流程 return runCatching { dateFormat.parse(dateStr) }.getOrNull() } }
关键注意事项
- 自定义的日期格式字符串必须和后端返回的字段值格式完全匹配,否则依然会出现解析失败
- 初始化
SimpleDateFormat时必须传入指定的Locale参数,避免跟随系统语言变化导致解析异常 - 如果后端存在多种日期格式返回的情况,可以在自定义TypeAdapter的
read方法中增加多格式容错逻辑,依次尝试匹配不同格式的日期字符串,匹配失败再返回null
内容的提问来源于stack exchange,提问作者Jun Shi Yan
相关产品推荐
相关产品推荐

