XListView 下拉/上拉刷新後佈局錯亂、資料遺失排查

現象

使用 XListView (或類似 Pull-to-Refresh ListView) 進行下拉刷新/上拉載入後，列表出現佈局錯位、資料列數減少。

排查步驟

1. 斷點確認資料源：在 onRefresh()/onLoadMore() 回調中，檢查解析後的資料列表 List<T> 筆數、內容是否正確。**若資料源已正確，問題在 Adapter/佈局；若資料源缺漏，問題在後端 API/解析邏輯。**
2. 檢查 Adapter 實作：
   • getView() 是否正確重用 convertView？
   • ViewHolder 模式是否正確綁定視圖？
   • 是否在 notifyDataSetChanged() 前正確更新了內部資料集合？
   • 多型列表 (getViewTypeCount/getItemViewType) 類型判斷是否正確？
3. 檢查佈局 XML：
   • Item 根佈局 layout_width/height 是否為 match_parent/wrap_content 正確？
   • 是否有固定高度導致擠壓？
   • ListView 本身 layout_height 是否被父佈局壓縮？
4. 分頁參數邏輯：
   • 上拉載入時 pageIndex 遞增邏輯是否正確？
   • 是否重複加入舊資料 (未清空舊列表) 或遺漏新資料？
5. Header/Footer View 干擾：XListView 內建 Header/Footer，getView 中 position 需扣除 Header 數量。

常見錯誤範例

// 錯誤：直接覆蓋列表導致舊資料遺失 (若為上拉載入)
adapter.setData(newList); 

// 正確：上拉載入追加
adapter.addAll(newList); 
// 或
oldList.addAll(newList);
adapter.notifyDataSetChanged();

建議替代方案

XListView 為早期第三方庫，已停止維護。建議遷移至：

• RecyclerView + SwipeRefreshLayout (官方標準，支援複雜佈局、動畫、分頁載入)。
• SmartRefreshLayout (功能豐富、API 友善、支援 RecyclerView/ListView/ScrollView)。
• Paging 3 Library (Jetpack 官方分頁載入框架，配合 RecyclerView)。

先確認資料源完整性，再檢視 Adapter 更新邏輯與 Item 佈局，多數佈局錯亂、資料遺失問題可定位解決。