You need to enable JavaScript to run this app. Android使用Retrofit与Gson解析Date类型字段出现时区报错问题咨询
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.22 18:45:04