Retrofit提交数据报错Expected BEGIN_OBJECT but was STRING问题排查

你遇到的Gson解析报错java.lang.IllegalStateException: Expected BEGIN_OBJECT but was STRING和列表参数没有直接关系，核心问题如下：

1. 后端实际返回的内容不是你预期的JSON结构：从OkHttp日志可以明确看到，接口返回的是纯文本数据库错误Incorrect date value: '02-07-2021' for column 'ReleaseDate' at row 1，响应头的Content-Type为text/html，Gson尝试将字符串解析为JSON对象自然抛出异常。
2. 你删除列表参数后请求成功属于巧合：大概率是你测试无列表参数的场景时，同步修改了日期参数的格式，刚好符合MySQL的日期字段要求，后端没有抛出错误、正常返回JSON结构，所以你误以为是列表参数导致的问题。

• 首先修复日期参数格式：MySQL的DATE类型默认支持的格式为YYYY-MM-DD，你当前传递的DD-MM-YYYY格式的日期不符合数据库字段规范，只需要在Android端将02-07-2021转换为2021-07-02格式后再提交即可。
• 你的列表参数写法无需修改：当前@Field("StaffList[]") StaffList:List<String>的写法符合Retrofit表单提交数组的规范，OkHttp日志中也已经能看到StaffList%5B%5D=10&StaffList%5B%5D=11&StaffList%5B%5D=12的参数，说明列表已经正确提交到后端。
• 可选优化：建议调整后端接口的响应逻辑，无论请求成功还是失败，都统一返回JSON格式的响应，同时设置响应头的Content-Type为application/json，避免前端出现解析异常。

内容的提问来源于stack exchange，提问作者Cemal Tüysüz