MVVM架构下Retrofit数据加载需屏幕旋转才显示的问题

以下是针对该问题的常见排查点和解决方案：

1. 检查LiveData的观察时机与生命周期绑定 #

确保在**Activity的onCreate()或Fragment的onViewCreated()**方法中观察LiveData，并且绑定正确的LifecycleOwner：

• Fragment中必须使用getViewLifecycleOwner()而非this，避免因Fragment生命周期不一致导致观察者未处于活跃状态；
• Activity中直接使用this作为LifecycleOwner。

示例代码：

// Fragment中
@Override
public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) {
    super.onViewCreated(view, savedInstanceState);
    MyViewModel viewModel = new ViewModelProvider(this).get(MyViewModel.class);
    viewModel.getDataLiveData().observe(getViewLifecycleOwner(), dataList -> {
        // 更新RecyclerView适配器
        myAdapter.submitList(dataList);
    });
    // 触发API请求
    viewModel.fetchData();
}

如果观察时机过晚（比如放在onStart()），可能API请求的回调已经完成，LiveData的更新不会触发观察者回调，直到屏幕旋转后重新观察时，LiveData才会发送缓存的最新数据。

2. 确保Retrofit回调中正确更新MutableLiveData #

Retrofit的enqueue()回调运行在子线程中，此时必须使用postValue()更新MutableLiveData，不能用setValue()（setValue()仅允许在主线程调用）。如果误用setValue()，会导致静默失败或抛出异常，LiveData无法正确更新。

示例代码（ViewModel/Repository中）：

public void fetchData() {
    ApiService apiService = RetrofitClient.getInstance().create(ApiService.class);
    Call<List<DataModel>> call = apiService.getData();
    call.enqueue(new Callback<List<DataModel>>() {
        @Override
        public void onResponse(Call<List<DataModel>> call, Response<List<DataModel>> response) {
            if (response.isSuccessful() && response.body() != null) {
                // 用postValue()在子线程更新LiveData
                dataLiveData.postValue(response.body());
            }
        }

        @Override
        public void onFailure(Call<List<DataModel>> call, Throwable t) {
            // 处理请求失败逻辑，比如发送错误状态
            dataLiveData.postValue(null);
        }
    });
}

3. 规范RecyclerView适配器的更新逻辑 #

• 推荐使用ListAdapter而非普通RecyclerView.Adapter，ListAdapter的submitList()方法会自动对比新旧数据并高效更新UI，无需手动调用notifyDataSetChanged()；
• 不要在适配器内部监听LiveData，数据更新逻辑应该放在Activity/Fragment中，通过ViewModel传递数据后更新适配器。

示例适配器定义：

public class DataAdapter extends ListAdapter<DataModel, DataAdapter.ViewHolder> {

    protected DataAdapter() {
        super(new DiffUtil.ItemCallback<DataModel>() {
            @Override
            public boolean areItemsTheSame(@NonNull DataModel oldItem, @NonNull DataModel newItem) {
                return oldItem.getId() == newItem.getId();
            }

            @Override
            public boolean areContentsTheSame(@NonNull DataModel oldItem, @NonNull DataModel newItem) {
                return oldItem.equals(newItem);
            }
        });
    }

    // ViewHolder定义与绑定逻辑...
}

4. 确认ViewModel的实例化方式正确 #

必须通过ViewModelProvider获取ViewModel实例，确保屏幕旋转等配置变化时ViewModel不会被重建，同时保证LiveData的观察者能持续接收更新。禁止手动new ViewModel，否则旋转后会创建新的ViewModel实例，旧实例中的LiveData更新无法被新实例的观察者接收。

正确实例化代码：

// Activity中
MyViewModel viewModel = new ViewModelProvider(this).get(MyViewModel.class);

// Fragment中
MyViewModel viewModel = new ViewModelProvider(this).get(MyViewModel.class);

5. 排查是否存在LiveData观察者重复注册或未移除的问题 #

如果多次注册观察者（比如在onResume()中重复调用observe()），可能导致回调逻辑混乱。确保每个LiveData只注册一次观察者，且绑定到正确的生命周期。

内容的提问来源于stack exchange，提问作者Himanshu Satone