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
相关产品推荐
相关产品推荐

