Retrofit请求新冠追踪Rapid API报Expected BEGIN_ARRAY错误求助
问题核心根源
你遇到的这个报错本质是Retrofit配置的返回数据结构和API实际返回的结构完全不匹配:
- 你在代码里把网络请求的返回泛型设置为
Call<List<Model>>,代表Gson解析器会默认要求接口最外层是JSON数组(以[开头) - 但你调用的这个Rapid COVID接口实际返回的最外层是JSON对象(以
{开头),两者结构从根节点就对不上,所以Gson直接抛出“根路径$处期望数组但实际为对象”的解析错误。
除此之外还有两个隐藏的代码问题,就算解析过了也拿不到数据:
- 你调用接口时传给
X-RapidAPI-Host和X-RapidAPI-Key请求头的全是空字符串,根本过不了RapidAPI的鉴权校验 - 你写的
Model实体类字段和接口实际返回的字段结构对不上,就算泛型改对也没法正常取到值
具体修正步骤
1. 匹配接口实际返回结构,调整实体类
别再写一层没有意义的Model类套数组了,先按接口真实的外层对象结构写对应的根响应实体类。比如这个接口实际返回的根结构是带names字段的对象,names本身是字符串列表,对应实体类写法如下:
// 对应接口最外层的JSON根对象 public class CovidNameResponse { // 对应接口返回里的names字段,类型是字符串列表,不是对象列表 private List<String> names; // Gson解析需要空构造、对应的getter/setter方法 public List<String> getNames() { return names; } public void setNames(List<String> names) { this.names = names; } }
2. 调整Retrofit接口的返回泛型
把原来的Call<List<Model>>换成和根响应匹配的泛型,去掉错误的数组泛型:
public interface Api { String BASE_URL = "https://who-covid-19-data.p.rapidapi.com/api/data/"; @GET("names") Call<CovidNameResponse> modelData( @Header("X-RapidAPI-Host") String apiHost, @Header("X-RapidAPI-Key") String apiKey ); }
3. 修正页面的接口调用逻辑
- 去掉多余的
ScalarsConverterFactory:做JSON结构化解析只需要留GsonConverterFactory就够了,同时加两个转换器容易因为优先级错乱导致解析逻辑异常 - 传真实的鉴权头值:别再传空字符串当请求头,要把你在RapidAPI控制台拿到的真实Host和Key值传进去
- 调整回调里的取值逻辑:从原来的遍历
Model列表,改成从根响应对象里取names列表再遍历
修正后的核心回调逻辑参考:
private void loadData () { Retrofit retrofit = new Retrofit.Builder() .baseUrl(Api.BASE_URL) // 只保留Gson转换器,去掉Scalars的配置 .addConverterFactory(GsonConverterFactory.create()) .build(); Api api = retrofit.create(Api.class); // 替换成你自己在RapidAPI控制台拿到的真实Host和Key,不要留空 Call<CovidNameResponse> call = api.modelData( "who-covid-19-data.p.rapidapi.com", "你的真实RapidAPI密钥" ); call.enqueue(new Callback<CovidNameResponse>() { @Override public void onResponse(Call<CovidNameResponse> call, Response<CovidNameResponse> response) { if(!response.isSuccessful()){ textView.setText("请求错误码:" + response.code()); return; } CovidNameResponse responseBody = response.body(); if(responseBody == null || responseBody.getNames() == null) { textView.setText("接口返回空数据"); return; } for(String name : responseBody.getNames()){ textView.append("Names :" + name + "\n"); } } @Override public void onFailure(Call<CovidNameResponse> call, Throwable t) { textView.setText(t.getMessage()); } }); }
注意:如果调整完泛型还是解析报错,就直接在浏览器里带鉴权头调用一次这个接口,把实际返回的JSON结构贴出来,再按实际字段一一对应写实体类,别靠猜接口结构。
内容的提问来源于stack exchange,提问作者Manoj Goshwami
相关产品推荐
相关产品推荐

