android listview 异步加载图片并防止错位

乐由心起

墨衍会员 · AI 创作全网分发码龄16年

关注

转载最新推荐文章于 2026-05-12 12:34:36 发布 1.7k 阅读 AI 写同款· GEO 优化 ›

android中ListView异步加载图片时的图片错位问题解决方案立即下载

网上找了一张图， listview 异步加载图片之所以错位的根本原因是重用了 convertView 且有异步操作.

如果不重用 convertView 不会出现错位现象，重用 convertView 但没有异步操作也不会有问题。

我简单分析一下：

当重用 convertView 时，最初一屏显示 7 条记录， getView 被调用 7 次，创建了 7 个 convertView.

当 Item1 划出屏幕， Item8 进入屏幕时，这时没有为 Item8 创建新的 view 实例， Item8 复用的是

Item1 的 view 如果没有异步不会有任何问题，虽然 Item8 和 Item1 指向的是同一个 view，但滑到

Item8 时刷上了 Item8 的数据，这时 Item1 的数据和 Item8 是一样的，因为它们指向的是同一块内存，

但 Item1 已滚出了屏幕你看不见。当 Item1 再次可见时这块 view 又涮上了 Item1 的数据。

但当有异步下载时就有问题了,假设 Item1 的图片下载的比较慢，Item8 的图片下载的比较快，你滚上去

使 Item8 可见，这时 Item8 先显示它自己下载的图片没错，但等到 Item1 的图片也下载完时你发现

Item8 的图片也变成了 Item1 的图片，因为它们复用的是同一个 view。如果 Item1 的图片下载的比

Item8 的图片快， Item1 先刷上自己下载的图片，这时你滑下去，Item8 的图片还没下载完， Item8

会先显示 Item1 的图片，因为它们是同一快内存，当 Item8 自己的图片下载完后 Item8 的图片又刷成

了自己的，你再滑上去使 Item1 可见， Item1 的图片也会和 Item8 的图片是一样的，

因为它们指向的是同一块内存。

最简单的解决方法就是网上说的，给 ImageView 设置一个 tag, 并预设一个图片。

当 Item1 比 Item8 图片下载的快时，你滚下去使 Item8 可见，这时 ImageView 的 tag 被设成了

Item8 的 URL，当 Item1 下载完时，由于 Item1 不可见现在的 tag 是 Item8 的 URL，所以不满足条件，

虽然下载下来了但不会设置到 ImageView 上, tag 标识的永远是可见 view 中图片的 URL。

关键代码如下：

public View getView(int position, View convertView, ViewGroup parent) {
        ViewHolder holder = null;

        if (convertView == null) {
            holder = new ViewHolder();
            convertView = LayoutInflater.from(context).inflate(
                    R.layout.list_item, null);
            holder.img = (ImageView) convertView.findViewById(R.id.userimage);

            convertView.setTag(holder);
        } else {
            holder = (ViewHolder) convertView.getTag();
        }

        final String imgUrl = list[position];
        // 给 ImageView 设置一个 tag
        holder.img.setTag(imgUrl);
        // 预设一个图片
        holder.img.setImageResource(R.drawable.ic_launcher);

        if (imgUrl != null && !imgUrl.equals("")) {
            Bitmap bitmap = imageLoader.loadImage(holder.img, imgUrl,
                    new ImageDownloadedCallBack() {

                        @Override
                        public void onImageDownloaded(ImageView imageView,
                                Bitmap bitmap) {
                            // 通过 tag 来防止图片错位
                            if (imageView.getTag() != null
                                    && imageView.getTag().equals(imgUrl)) {
                                imageView.setImageBitmap(bitmap);
                            }
                        }
                    });

            if (bitmap != null) {
                holder.img.setImageBitmap(bitmap);
            }
        }

        return convertView;
    }

我参考网上资料写了一个 listview 异步加载图片的 DEMO：

(1) 使用线程池

没有线程池，当图片非常多，快速滑动 listview 时由于下载每个图片都开了一个线程，

可能出现 OOM （out of memory）。

(2) 内存、文件双缓存

内存缓存使用 LruCache，顾名思义基于 LRU 算法，每次回收最近最少被使用的对象　

/**
 * 图片异步加载类
 * 
 * @author Leslie.Fang
 * 
 */
public class AsyncImageLoader {
    // 最大线程数
    private static final int MAX_THREAD_NUM = 10;
    // 一级内存缓存基于 LruCache
    private BitmapCache bitmapCache;
    // 二级文件缓存
    private FileUtil fileUtil;
    // 线程池
    private ExecutorService threadPools = null;

    public AsyncImageLoader(Context context) {
        bitmapCache = new BitmapCache();
        fileUtil = new FileUtil(context);
        threadPools = Executors.newFixedThreadPool(MAX_THREAD_NUM);
    }

    public Bitmap loadImage(final ImageView imageView, final String imageUrl,
            final ImageDownloadedCallBack imageDownloadedCallBack) {
        final String filename = imageUrl
                .substring(imageUrl.lastIndexOf("/") + 1);
        final String filepath = fileUtil.getAbsolutePath() + "/" + filename;

        // 先从内存中拿
        Bitmap bitmap = bitmapCache.getBitmap(imageUrl);

        if (bitmap != null) {
            Log.i("aaaa", "image exists in memory");
            return bitmap;
        }

        // 从文件中找
        if (fileUtil.isBitmapExists(filename)) {
            Log.i("aaaa", "image exists in file" + filename);
            bitmap = BitmapFactory.decodeFile(filepath);

            // 重新缓存到内存中
            bitmapCache.putBitmap(imageUrl, bitmap);
            return bitmap;
        }

        // 内存和文件中都没有再从网络下载
        if (imageUrl != null && !imageUrl.equals("")) {
            final Handler handler = new Handler() {
                @Override
                public void handleMessage(Message msg) {
                    if (msg.what == 111 && imageDownloadedCallBack != null) {
                        Bitmap bitmap = (Bitmap) msg.obj;
                        imageDownloadedCallBack.onImageDownloaded(imageView,
                                bitmap);
                    }
                }
            };

            Thread thread = new Thread() {
                @Override
                public void run() {
                    Log.i("aaaa", Thread.currentThread().getName()
                            + " is running");
                    InputStream inputStream = HTTPService.getInstance()
                            .getStream(imageUrl);
                    Bitmap bitmap = BitmapFactory.decodeStream(inputStream);

                    // 图片下载成功后缓存并执行回调刷新界面
                    if (bitmap != null) {
                        // 先缓存到内存
                        bitmapCache.putBitmap(imageUrl, bitmap);
                        // 缓存到文件系统
                        fileUtil.saveBitmap(filepath, bitmap);

                        Message msg = new Message();
                        msg.what = 111;
                        msg.obj = bitmap;
                        handler.sendMessage(msg);
                    }
                }
            };

            threadPools.execute(thread);
        }

        return null;
    }

    public void shutDownThreadPool() {
        if (threadPools != null) {
            threadPools.shutdown();
            threadPools = null;
        }
    }

    /**
     * 图片下载完成回调接口
     * 
     */
    public interface ImageDownloadedCallBack {
        void onImageDownloaded(ImageView imageView, Bitmap bitmap);
    }
}