You need to enable JavaScript to run this app. Retrofit请求新冠追踪Rapid API报Expected BEGIN_ARRAY错误求助
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.01 15:24:03