Picasso加载图片至Target异常：谷歌地图标记/GroundOverlay加载不稳定

嘿，看你遇到的这个Picasso加载图片到Google Map标记时不稳定的问题，我太熟悉了——这几乎都是几个常见的坑导致的，结合你说的“有时全加载成功、有时只加载部分，甚至完全失败，失败时还触发onPrepareLoad”的现象，我给你拆解下核心原因和亲测有效的修复方案：

一、头号元凶：Target被垃圾回收（GC） #

这是Picasso加载Target时最容易踩的坑！如果你的Target是在循环里创建的匿名内部类，或者没有被强引用牢牢持有，那在图片加载的异步过程中，GC很容易把它回收掉，直接导致请求中断，看起来就是“加载失败”。你提到的onPrepareLoad被触发，其实这是加载前的回调，如果Target被回收，请求会被取消，反而可能触发这个方法，这刚好印证了这个问题。

修复方案： #

把所有Target对象存到一个全局的集合里，保持强引用，直到图片加载完成后再移除：

// 全局集合，专门用来持有Target引用，避免被GC回收
private List<Picasso.Target> markerTargets = new ArrayList<>();

// 你的循环逻辑里修改如下
while (count < ts_news_data_id.size()) {
    int index = il_id_data.indexOf(mainMarkers.get(count));
    // 创建Target对象
    Picasso.Target target = new Picasso.Target() {
        @Override
        public void onBitmapLoaded(Bitmap bitmap, Picasso.LoadedFrom from) {
            // 成功加载后，设置到Google Marker或GroundOverlay
            Marker marker = mainMarkers.get(count);
            if (marker != null) {
                marker.setIcon(BitmapDescriptorFactory.fromBitmap(bitmap));
            }
            // 加载完成，从集合里移除这个Target，避免内存占用
            markerTargets.remove(this);
        }

        @Override
        public void onBitmapFailed(Exception e, Drawable errorDrawable) {
            Log.d("PicassoError", "图片加载失败：" + e.getMessage());
            markerTargets.remove(this);
        }

        @Override
        public void onPrepareLoad(Drawable placeHolderDrawable) {
            Log.d("PicassoLog", "准备加载，注意：如果频繁触发这里，大概率是Target被GC回收了");
        }
    };
    // 先把Target加入集合，再发起加载请求！顺序不能反
    markerTargets.add(target);
    // 发起Picasso加载请求
    Picasso.get()
            .load(yourImageUrl) // 替换成你的图片URL
            .into(target);
    count++;
}

二、循环同步处理导致的请求阻塞 #

如果你的while循环是在非UI线程执行，或者循环里有耗时操作，可能会导致Picasso的请求队列被阻塞，或者Target的回调无法及时执行。另外，Picasso本身是异步加载的，但如果一次性发起太多请求，也可能导致部分请求超时。

修复方案： #

1. 确保所有Picasso的加载请求都在UI线程发起（Picasso官方要求into(Target)必须在UI线程调用）；
2. 限制Picasso的并发请求数，避免同时发起太多请求：

// 自定义Picasso实例，限制并发数
Picasso picasso = new Picasso.Builder(context)
        .downloader(new OkHttp3Downloader(context, Integer.MAX_VALUE))
        .executor(Executors.newFixedThreadPool(3)) // 把并发数设为3，可根据你的需求调整
        .build();
// 用这个自定义实例发起请求
picasso.load(yourImageUrl).into(target);

三、图片加载的缓存与重试配置 #

部分图片加载失败可能是因为网络波动、缓存未命中，或者Picasso默认的重试机制不够给力。

修复方案： #

1. 开启Picasso的缓存指示器，方便调试图片是从内存/磁盘还是网络加载：

Picasso.get().setIndicatorsEnabled(true); // 开启后，图片左上角会有颜色标记，绿色=内存缓存，蓝色=磁盘缓存，红色=网络

2. 给Picasso添加重试机制，比如用OkHttp的拦截器实现（前提是用OkHttp作为Picasso的下载器）：

// 自定义重试拦截器
public class RetryInterceptor implements Interceptor {
    private final int maxRetryCount;

    public RetryInterceptor(int maxRetryCount) {
        this.maxRetryCount = maxRetryCount;
    }

    @Override
    public Response intercept(Chain chain) throws IOException {
        Request request = chain.request();
        IOException lastException = null;
        for (int i = 0; i < maxRetryCount; i++) {
            try {
                return chain.proceed(request);
            } catch (IOException e) {
                lastException = e;
                // 可以在这里添加重试的条件，比如只重试网络错误
                if (!isRetryable(e)) {
                    throw e;
                }
            }
        }
        throw lastException;
    }

    private boolean isRetryable(IOException e) {
        return e instanceof ConnectException || e instanceof SocketTimeoutException;
    }
}

// 配置给Picasso
OkHttpClient okHttpClient = new OkHttpClient.Builder()
        .addInterceptor(new RetryInterceptor(3)) // 重试3次
        .build();

Picasso picasso = new Picasso.Builder(context)
        .downloader(new OkHttp3Downloader(okHttpClient))
        .build();

四、Google Map的线程安全问题 #

Google Map的所有UI操作（比如设置Marker图标）都必须在主线程执行，虽然Picasso的Target回调默认是在主线程，但如果你的代码逻辑不小心把回调切换到了其他线程，也会导致设置失败，看起来像是加载失败。

修复方案： #

在onBitmapLoaded里强制切换到主线程操作Map：

@Override
public void onBitmapLoaded(Bitmap bitmap, Picasso.LoadedFrom from) {
    // 确保在主线程操作Google Map
    ((Activity) context).runOnUiThread(() -> {
        Marker marker = mainMarkers.get(count);
        if (marker != null && marker.isVisible()) {
            marker.setIcon(BitmapDescriptorFactory.fromBitmap(bitmap));
        }
    });
}

调试小技巧 #

开启Picasso的日志，查看每一个请求的状态：

Picasso.get().setLoggingEnabled(true);

这样你可以在Logcat里看到每个请求的详细日志，包括是成功、失败还是被取消，方便快速定位问题。

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