
当设备切换 wi-fi 网络时,recyclerview 显示空白,重启 app 后数据恢复——这通常源于未妥善处理网络状态变更导致的数据源重置或缓存失效,需结合生命周期感知、本地缓存与网络监听实现鲁棒性恢复。
当设备切换 wi-fi 网络时,recyclerview 显示空白,重启 app 后数据恢复——这通常源于未妥善处理网络状态变更导致的数据源重置或缓存失效,需结合生命周期感知、本地缓存与网络监听实现鲁棒性恢复。
在 Android 开发中,RecyclerView 本身不持有数据,其显示内容完全依赖于 Adapter 所持有的数据集合(如 List<Mesa>)。从您提供的 MesaAdapter 代码可见:该 Adapter 直接持有一个强引用的 mesas 列表,但未与网络状态变化解耦,也未集成任何数据持久化或离线缓存机制。当 Wi-Fi 切换触发系统级网络重连时,若业务逻辑中存在如下任一情况,便极易导致列表“丢失”:
- 在 ConnectivityManager.CONNECTIVITY_ACTION 广播中意外清空了 mesas 列表;
- 网络切换后自动触发了未加防护的远程刷新(如调用 loadFromServer()),而此时请求失败却未回退至本地缓存;
- Activity 或 Fragment 因配置变更(如网络切换可能触发某些厂商 ROM 的非标准重建)被重建,但 Adapter 数据未保存/恢复。
✅ 正确做法不是让 Adapter 自行监听网络,而是由 Activity/Fragment 层统一管理网络状态 + 数据生命周期,并确保 Adapter 始终基于可靠数据源更新。
一、推荐架构:分层响应网络变更
- 使用 ConnectivityManager 监听网络状态(适配 Android 7.0+ 推荐 NetworkCallback,兼容旧版可沿用 BroadcastReceiver)
- 引入本地缓存层(如 Room 或简单内存/文件缓存),确保即使网络中断,mesas 列表仍可从缓存读取;
- 在 UI 层(Activity/Fragment)中响应网络恢复事件,触发安全刷新(带错误回退);
- 避免在 Adapter 中持有 Activity 强引用或执行网络操作——您已正确使用 WeakReference,值得肯定。
二、关键代码实践(精简可集成版)
// ✅ 在 Activity/Fragment 中注册网络监听(示例使用 BroadcastReceiver 兼容老版本)
private NetworkChangeReceiver networkChangeReceiver;
private boolean isNetworkAvailable = true;
private void setupNetworkMonitoring() {
networkChangeReceiver = new NetworkChangeReceiver();
registerReceiver(networkChangeReceiver,
new IntentFilter(ConnectivityManager.CONNECTIVITY_ACTION));
}
private class NetworkChangeReceiver extends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent) {
if (!intent.getAction().equals(ConnectivityManager.CONNECTIVITY_ACTION)) return;
boolean isConnected = isNetworkConnected(context);
if (isConnected && !isNetworkAvailable) {
isNetworkAvailable = true;
// 安全刷新:仅当有新数据可拉取时才请求,否则保持缓存
refreshDataIfNecessary();
} else if (!isConnected && isNetworkAvailable) {
isNetworkAvailable = false;
// 可选:Toast 提示“已进入离线模式”,或更新 UI 状态栏图标
showOfflineHint();
}
}
}
private boolean isNetworkConnected(Context context) {
ConnectivityManager cm = (ConnectivityManager) context.getSystemService(Context.CONNECTIVITY_SERVICE);
NetworkInfo active = cm.getActiveNetworkInfo();
return active != null && active.isConnected();
}
private void refreshDataIfNecessary() {
// ✅ 核心原则:网络恢复 ≠ 立即刷新!应判断是否需要同步(例如:本地缓存过期 or 用户主动下拉)
if (shouldFetchFreshData()) {
fetchMesasFromServer(); // 实现中需包含:成功→更新Adapter+保存缓存;失败→保留当前缓存并提示
}
}⚠️ 注意事项:
- BroadcastReceiver 必须在 onDestroy() 或 onStop() 中及时 unregisterReceiver(),避免内存泄漏(您答案中的 onDestroy() 方法位置不妥——不应放在 Adapter 内,而应在宿主 Activity 中调用);
- fetchMesasFromServer() 应使用 ViewModel + LiveData / StateFlow 管理异步结果,确保配置变更后数据不丢失;
- MesaAdapter 应提供 submitList() 方法(配合 ListAdapter)或 updateData(List<Mesa>) 方法,支持安全的数据替换(避免直接 mesas.clear() / addAll() 引发并发异常)。
三、终极建议:升级为 ListAdapter + DiffUtil
将当前继承自 Adapter 的 MesaAdapter 迁移为 ListAdapter<Mesa, MesaViewHolder>,可彻底规避因手动 notifyDataSetChanged() 导致的闪烁、状态丢失等问题,并天然支持异步差分更新:
public class MesaAdapter extends ListAdapter<Mesa, MesaViewHolder>
implements OnClickListener, OnLongClickListener {
private final OnSelectedMesaListener listener;
public MesaAdapter(OnSelectedMesaListener listener) {
super(DIFF_CALLBACK);
this.listener = listener;
}
private static final DiffUtil.Callback DIFF_CALLBACK = new DiffUtil.Callback() {
@Override public int getOldListSize() { return getCurrentList().size(); }
@Override public int getNewListSize() { return getCurrentList().size(); }
@Override public boolean areItemsTheSame(@NonNull Mesa oldItem, @NonNull Mesa newItem) {
return oldItem.getId() == newItem.getId();
}
@Override public boolean areContentsTheSame(@NonNull Mesa oldItem, @NonNull Mesa newItem) {
return oldItem.equals(newItem);
}
};
// onBindViewHolder 等保持不变,但数据更新只需调用 submitList(newList)
}然后在 Activity 中:
adapter.submitList(cachedMesas); // 初始化 // 网络恢复后: repository.getMesas().observe(this, mesas -> adapter.submitList(mesas)); // 自动高效更新
? 总结:RecyclerView “丢数据”的本质是数据源管理失控,而非 UI 组件缺陷。通过「网络状态感知 + 本地缓存兜底 + ListAdapter 差分更新」三位一体方案,即可实现无缝离线/在线体验,彻底解决 Wi-Fi 切换引发的显示异常。

















