RecyclerView单元格中ViewPager无法显示图片问题求助

嗨，我之前也碰到过类似的情况，RecyclerView的Item里放ViewPager总是不显示图片，大概率是这几个细节没处理到位，你可以逐个排查：

1. 优先检查ViewPager的高度问题 #

RecyclerView的Item默认是wrap_content，但原生ViewPager没办法自动根据内容适配高度，如果你的ViewPager设置的是wrap_content，很可能初始高度为0，导致图片看不见。

解决办法：
要么给ViewPager设置固定高度（比如android:height="200dp"），要么自定义一个能自适应高度的ViewPager：

public class WrapContentHeightViewPager extends ViewPager {
    public WrapContentHeightViewPager(Context context) {
        super(context);
    }

    public WrapContentHeightViewPager(Context context, AttributeSet attrs) {
        super(context, attrs);
    }

    @Override
    protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
        int calculatedHeight = 0;
        // 遍历子View，获取最高的那个高度作为ViewPager的高度
        for (int i = 0; i < getChildCount(); i++) {
            View childView = getChildAt(i);
            childView.measure(widthMeasureSpec, MeasureSpec.makeMeasureSpec(0, MeasureSpec.UNSPECIFIED));
            int childHeight = childView.getMeasuredHeight();
            if (childHeight > calculatedHeight) {
                calculatedHeight = childHeight;
            }
        }
        // 重新设置测量规格
        heightMeasureSpec = MeasureSpec.makeMeasureSpec(calculatedHeight, MeasureSpec.EXACTLY);
        super.onMeasure(widthMeasureSpec, heightMeasureSpec);
    }
}

之后在布局里用这个自定义ViewPager替换原生的ViewPager即可。

2. 确认ViewPager适配器的逻辑是否正确 #

你在onBindViewHolder里设置适配器的时候，要注意这几点：

• 确保每次绑定的都是当前Item对应的图片列表，不要复用其他Item的数据源
• 不要每次都重新创建ViewHolder里的ViewPager实例，应该在ViewHolder构造方法里初始化一次，onBind时只更新适配器数据
• 设置适配器后记得调用notifyDataSetChanged()确保数据刷新

示例代码：

@Override
public void onBindViewHolder(ViewHolder holder, int position) {
    AndroidVersion currentItem = android_versions.get(position);
    // 假设AndroidVersion里有存储图片URL的列表imageUrls
    ImagePagerAdapter pagerAdapter = new ImagePagerAdapter(context, currentItem.getImageUrls());
    holder.viewPager.setAdapter(pagerAdapter);
    pagerAdapter.notifyDataSetChanged();
}

// ViewHolder的构造方法
public static class ViewHolder extends RecyclerView.ViewHolder {
    WrapContentHeightViewPager viewPager;

    public ViewHolder(View itemView) {
        super(itemView);
        viewPager = itemView.findViewById(R.id.item_view_pager);
        // 这里只初始化一次ViewPager，不要每次onBind都new
    }
}

3. 检查图片加载的环节 #

如果用Glide、Picasso这些图片加载库，要确认：

• 上下文是否正确（不要用ApplicationContext加载ImageView，尽量用当前Activity的Context）
• 图片URL是否有效（可以直接复制URL到浏览器打开测试）
• 针对Android 9及以上版本，如果加载的是HTTP图片，需要在AndroidManifest.xml里配置网络安全策略：

<application
    ...
    android:networkSecurityConfig="@xml/network_security_config">
</application>

然后在res/xml下创建network_security_config.xml：

<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
    <base-config cleartextTrafficPermitted="true" />
</network-security-config>

4. 处理RecyclerView的复用问题 #

ViewHolder复用时，可能会导致ViewPager残留之前的适配器数据，所以可以在onBind时先清空旧适配器，再设置新的：

@Override
public void onBindViewHolder(ViewHolder holder, int position) {
    // 先清空旧适配器
    holder.viewPager.setAdapter(null);
    
    AndroidVersion currentItem = android_versions.get(position);
    ImagePagerAdapter pagerAdapter = new ImagePagerAdapter(context, currentItem.getImageUrls());
    holder.viewPager.setAdapter(pagerAdapter);
}

你可以按照这个顺序排查，一般前两点就能解决问题啦！

内容的提问来源于stack exchange，提问作者Kunal Das