萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android ListView 數據更新同步難題:背景執行緒修改 Adapter 導致崩潰的解決方案

問題現場

背景執行緒(HandlerThread)查詢資料庫、更新資料源 mGroupArray,隨即呼叫 adapter.notifyDataSetChanged() 導致兩類崩潰:

  1. IndexOutOfBoundsException:資料源與 Adapter 狀態不一致(並發修改)。
  2. The content of the adapter has changed but ListView did not receive a notification:非 UI 執行緒修改 Adapter 內容。

根本原因

  • UI 元件非執行緒安全:ListView/Adapter 必須在主執行緒存取/修改。
  • 共享可變資料:背景執行緒與 UI 執行緒同時讀寫 mGroupArray,無同步機制。

正確模式:背景查詢 → 主執行緒更新


HandlerThread dbThread = new HandlerThread("db-thread");
dbThread.start();
Handler dbHandler = new Handler(dbThread.getLooper());

Handler uiHandler = new Handler(Looper.getMainLooper()) {
    @Override public void handleMessage(Message msg) {
        if (msg.what == MSG_UPDATE) {
            @SuppressWarnings("unchecked")
            List newData = (List) msg.obj;
            mGroupArray.clear();
            mGroupArray.addAll(newData);
            adapter.notifyDataSetChanged(); // 安全:主執行緒
        }
    }
};

dbHandler.post(() -> {
    List fresh = queryServerAndLocal(); // 耗時操作
    uiHandler.obtainMessage(MSG_UPDATE, fresh).sendToTarget();
});

進階方案:DiffUtil + RecyclerView(替代 ListView)


DiffUtil.Callback diffCallback = new DiffUtil.Callback() {
    @Override public int getOldListSize() { return oldList.size(); }
    @Override public int getNewListSize() { return newList.size(); }
    @Override public boolean areItemsTheSame(int o, int n) { return oldList.get(o).id == newList.get(n).id; }
    @Override public boolean areContentsTheSame(int o, int n) { return oldList.get(o).equals(newList.get(n)); }
};
DiffUtil.DiffResult diffResult = DiffUtil.calculateDiff(diffCallback);
adapter.setData(newList); // 內部呼叫 notifyItemRangeChanged 等精細通知
diffResult.dispatchUpdatesTo(adapter);

優勢:最小化 UI 刷新、自動計算動畫、避免 notifyDataSetChanged() 全量重繪。

若必須用 ListView:同步鎖保護資料源


private final Object dataLock = new Object();
private List mGroupArray = new ArrayList<>();

// 背景執行緒寫入
synchronized (dataLock) {
    mGroupArray.clear();
    mGroupArray.addAll(freshData);
}
// 主執行緒讀取並通知
synchronized (dataLock) {
    adapter.notifyDataSetChanged();
}

但仍建議遷移至 RecyclerView + ListAdapter(內建 DiffUtil、異步提交)。

關鍵原則總結

  1. 資料查詢/計算 → 背景執行緒。
  2. 資料源更新 + Adapter 通知 → 主執行緒。
  3. 傳遞資料用 Handler、LiveData、RxJava、Coroutines 等機制安全跨執行緒。
  4. 不可變資料結構(Kotlin List、data class)減少同步複雜度。

遵循「背景算、主線改、安全傳」原則,徹底解決 ListView/RecyclerView 數據同步崩潰。

copyright © 萬盛學電腦網 all rights reserved