You need to enable JavaScript to run this app. Retrofit2请求报错Expected BEGIN_ARRAY but was BEGIN_OBJECT 问题求解
优惠活动
大模型
产品
解决方案
定价
更多

Retrofit2请求报错Expected BEGIN_ARRAY but was BEGIN_OBJECT 问题求解

错误核心原因

该报错的本质是Retrofit 的 Gson 解析器期望的 JSON 结构与实际接口返回结构不匹配:

  • 接口实际返回的根节点是 JSON 对象(以 { 开头,对应内容 {"mostpopularmovies": [...]})
  • 你的代码中接口定义返回 Call<List<Video>>,Gson 会按预期将根节点解析为 JSON 数组(以 [ 开头)
  • 解析到根路径 $ 时发现是对象而非数组,因此抛出上述错误。
分步解决方案

1. 新增外层响应包装类

新建一个类匹配接口返回的根对象结构,用于承载 mostpopularmovies 字段的数组:

public class PopularMoviesResponse {
    @SerializedName("mostpopularmovies")
    private List<Video> mostPopularMovies;

    // 新增 Getter 方法
    public List<Video> getMostPopularMovies() {
        return mostPopularMovies;
    }
}

2. 修改 Retrofit 接口定义

将接口的返回类型从 Call<List<Video>> 改为 Call<PopularMoviesResponse>:

public interface MovieApi {
    @GET("mostpopularmovies")
    Call<PopularMoviesResponse> getPopularMovies(@Query("API-KEY") String apiKey);
}

3. 调整请求逻辑代码

修改 getPopularData() 方法,适配新的返回类型,从包装类中提取电影列表:

private void getPopularData() {
    Retrofit retrofit = RetrofitClient.getRetrofitInstance();
    MovieApi api = retrofit.create(MovieApi.class);
    // 修改 Call 的泛型为新的包装类
    Call<PopularMoviesResponse> call = api.getPopularMovies(Config.API_KEY);
    call.enqueue(new Callback<PopularMoviesResponse>() {
        @Override
        public void onResponse(Call<PopularMoviesResponse> call, retrofit2.Response<PopularMoviesResponse> response) {
            if (response.code() == 200 && response.body() != null) {
                // 从包装类中取出实际的电影列表
                List<Video> videoList = response.body().getMostPopularMovies();
                // 增加空列表判断,避免空指针
                if (videoList == null || videoList.isEmpty()) return;

                for (int i = 0; i < videoList.size(); i++){
                    Video video = videoList.get(i);
                    CommonModels models =new CommonModels();
                    models.setImageUrl(video.getThumbnailUrl());
                    models.setTitle(video.getTitle());
                    models.setQuality(video.getVideoQuality());
                    models.setReleaseDate(video.getRelease());
                    models.setImdb_rating(video.getImdb_rating());
                    models.setId(video.getVideosId());
                    list.add(models);
                }

                mAdapter.notifyDataSetChanged();
            }
        }

        @Override
        public void onFailure(Call<PopularMoviesResponse> call, Throwable t) {
            // 优化日志输出,打印完整堆栈
            Log.e("ERROR", "请求失败: " + Log.getStackTraceString(t));
        }
    });
}
补充说明
  • 字段自动兼容: 你定义的 Video 实体类中包含 videos_id、thumbnail_url 等当前接口未返回的字段,Gson 会自动将未匹配的字段设为 null,不会影响解析流程,后续接口补充对应字段时也无需修改实体类。
  • 空判断优化: 原代码未做 response.body() 的非空校验,若接口返回 200 但响应体为空,会触发空指针异常,上述代码已补充对应判断。

内容的提问来源于stack exchange,提问作者Meggan Sam

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.21 00:54:10