Android Kotlin解析JSON报错Expected BEGIN_OBJECT but was STRING如何解决

首先明确：你提供的服务端JSON结构、对应的Kotlin实体类定义是完全匹配的，两者本身没有错误，报错是出在响应获取到解析的中间流程。

报错含义 #

JsonSyntaxException: java.lang.IllegalStateException: Expected BEGIN_OBJECT but was STRING at line 1 column 1 path $ 的核心是JSON解析库（通常是Gson）在读取响应内容的第一个字符时，预期会找到JSON对象的起始标识{，但实际读取到的是字符串类型的内容。 #

常见引发原因 #

• 服务端实际返回的不是纯JSON内容：你贴的是接口示例返回，但实际请求时服务端可能在JSON前加了多余的BOM头、空格、HTML标签，或者接口异常时直接返回了纯文本错误提示（比如"参数错误""鉴权失败"这类字符串）
• 网络请求框架配置错误：比如使用Retrofit时重复配置了转换器、调用了response.string()读取响应后又将该字符串传给Gson二次解析，或者拦截器中修改响应体时误将JSON做了字符串转义
• 编码不匹配：服务端返回的响应编码和客户端默认解析编码不一致，导致开头的{被解析为乱码字符串，无法被JSON解析器识别

修复方案 #

1. 优先打印完整的实际响应内容：接入OkHttp的LoggingInterceptor，打印完整的响应体内容，确认第一个字符是否为{，有没有多余的前缀内容
2. 若存在多余前缀：如果是服务端配置问题，推动服务端返回纯JSON内容；如果无法修改服务端，客户端拿到响应体后先裁剪掉多余的前缀字符，再传给解析器
3. 检查网络请求配置：确认Retrofit只配置了一次GsonConverterFactory，不要重复调用response.string()（该方法只能调用一次，第二次读取会返回空内容），检查拦截器逻辑是否有修改响应格式的操作
4. 修复编码问题：如果确认是编码不匹配，可在客户端拿到响应字节数组后，用服务端对应的编码格式转成字符串再解析，或者给OkHttp配置指定的响应编码

内容的提问来源于stack exchange，提问作者reza.fathi921