Android PullToRefreshGridView 數據不顯示：排查思路與常見解決方案

問題現象

配置了 PullToRefreshGridView，寬高、列數、間距均已設置，但數據不顯示。

XML 布局片段

<com.handmark.pulltorefresh.library.PullToRefreshGridView
    android:id="@+id/select_history_time_grid"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:layout_marginTop="8dp"
    android:listSelector="#00000000"
    android:numColumns="2"
    android:scrollbars="none"
    android:verticalSpacing="10dp" />

核心排查步驟

1. 確認數據源非空（最常見原因）

// 在設置 Adapter 前打印日誌
List<YourBean> dataList = getData();
Log.d("GridViewDebug", "數據源大小: " + (dataList != null ? dataList.size() : "null"));
if (dataList == null || dataList.isEmpty()) {
    // 處理空數據情況：顯示佔位圖或提示文本
    return;
}

2. 正確獲取內部 GridView 並設置 Adapter

PullToRefreshGridView pullRefreshGridView = findViewById(R.id.select_history_time_grid);
// 關鍵：必須獲取內部的 GridView
GridView gridView = pullRefreshGridView.getRefreshableView();

YourAdapter adapter = new YourAdapter(this, dataList);
gridView.setAdapter(adapter); // 而不是 pullRefreshGridView.setAdapter()

3. 檢查 Adapter 實現

public class YourAdapter extends BaseAdapter {
    @Override
    public int getCount() {
        return dataList.size(); // 確保返回正確數量
    }
    
    @Override
    public View getView(int position, View convertView, ViewGroup parent) {
        // 確保正確 inflate 佈局並綁定數據
        // 建議使用 ViewHolder 模式優化性能
    }
}

4. 佈局高度問題排查

如果 PullToRefreshGridView 在 ScrollView 或 NestedScrollView 內，會導致高度測量異常。解決方案：

• 使用 ListView/GridView 專用的 PullToRefresh 容器
• 或自定義 GridView 重寫 onMeasure：

public class MyGridView extends GridView {
    public MyGridView(Context context, AttributeSet attrs) {
        super(context, attrs);
    }
    @Override
    protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
        int expandSpec = MeasureSpec.makeMeasureSpec(Integer.MAX_VALUE >> 2, MeasureSpec.AT_MOST);
        super.onMeasure(widthMeasureSpec, expandSpec);
    }
}

5. 刷新狀態重置

數據加載完成後，必須調用：

pullRefreshGridView.onRefreshComplete();
// 如果是加載更多
pullRefreshGridView.onRefreshComplete();
// 並確保 Adapter 數據更新後 notifyDataSetChanged()
adapter.notifyDataSetChanged();

完整調試清單

1. ✅ 數據源是否為空？
2. ✅ 是否調用 getRefreshableView() 獲取真實 GridView？
3. ✅ Adapter 的 getCount() 是否返回 > 0？
4. ✅ getView() 是否正確返回 View？
5. ✅ 是否在 ScrollView 嵌套導致測量失敗？
6. ✅ 數據加載後是否調用 notifyDataSetChanged()？
7. ✅ 是否調用 onRefreshComplete() 重置刷新狀態？

總結

90% 的「不顯示數據」問題源於 數據源為空 或 未正確獲取內部 GridView 設置 Adapter。按清單逐項排查即可定位。