如何预填充Glide缓存以避免照片重复下载？

我刚好碰到过一模一样的场景，要搞定这个重复下载延迟的问题，核心思路就是让Glide把本地文件的内容和远程URI对应的缓存键绑定起来——这样后续不管哪台设备加载这个远程URI，只要缓存里有预存的内容，就不用重新下载了。下面分享两种实用的解决方案：

方案一：手动写入Glide磁盘缓存（适合简单场景） #

这个方法直接操作Glide的磁盘缓存，把本地文件内容存入远程URI对应的缓存条目，步骤很清晰：

1. 生成匹配远程URI的缓存键
   缓存键的生成必须和你后续加载远程URI时的参数完全一致（比如RequestOptions、图片尺寸等），否则Glide会认不出这个缓存。示例代码：

   val context = applicationContext
   val remoteUri = Uri.parse("你的远程资源URI")
   val localFilePath = "本地文件的绝对路径"
   
   // 复用你平时加载图片用的RequestOptions，确保缓存策略、转换操作完全一致
   val requestOptions = RequestOptions()
       .diskCacheStrategy(DiskCacheStrategy.ALL)
       .centerCrop() // 如果有圆角、缩放这类转换，必须同步添加
   
   // 构建ModelLoader生成对应远程URI的缓存键
   val glide = Glide.with(context)
   val modelLoader = glide.buildModelLoader(remoteUri, InputStream::class.java)
   val cacheKey = modelLoader?.buildLoadData(remoteUri, 0, 0, requestOptions)?.cacheKey
   

2. 将本地文件写入缓存
   获取Glide的磁盘缓存实例，把本地文件的内容写入对应缓存键的条目：

   cacheKey?.let { key ->
       glide.diskCache?.put(key) { outputStream ->
           val localFile = File(localFilePath)
           FileInputStream(localFile).use { inputStream ->
               inputStream.copyTo(outputStream)
           }
           true // 返回true表示缓存写入成功
       }
   }
   

这个方案的优点是直接高效，不需要自定义组件，适合没有复杂图片转换的场景。

方案二：自定义ModelLoader预加载（适合复杂场景） #

如果你的图片加载有较多自定义转换（比如圆角、滤镜、自定义裁剪等），或者需要同时缓存转换后的Bitmap，推荐用自定义ModelLoader的方式，让Glide预加载时用本地文件，但缓存键绑定远程URI：

1. 创建自定义Model类
   这个类用来封装本地文件和远程URI的关联关系：

   data class PreloadCacheModel(val localFile: File, val remoteUri: Uri)
   

2. 实现自定义ModelLoader和DataFetcher
   让ModelLoader用远程URI生成缓存键，但实际从本地文件读取数据：

   class PreloadCacheModelLoader(private val context: Context) : ModelLoader<PreloadCacheModel, InputStream> {
       override fun handles(model: PreloadCacheModel): Boolean = true
   
       override fun buildLoadData(
           model: PreloadCacheModel,
           width: Int,
           height: Int,
           options: Options
       ): LoadData<InputStream>? {
           // 用远程URI生成缓存键，保证和后续加载时的缓存键完全一致
           val uriLoader = Glide.with(context).buildModelLoader(model.remoteUri, InputStream::class.java)
           val cacheKey = uriLoader?.buildLoadData(model.remoteUri, width, height, options)?.cacheKey
           return LoadData(cacheKey, PreloadDataFetcher(model.localFile))
       }
   
       // 负责从本地文件读取数据的DataFetcher
       class PreloadDataFetcher(private val localFile: File) : DataFetcher<InputStream> {
           override fun loadData(priority: Priority, callback: DataCallback<in InputStream>) {
               try {
                   callback.onDataReady(FileInputStream(localFile))
               } catch (e: FileNotFoundException) {
                   callback.onLoadFailed(e)
               }
           }
   
           override fun cleanup() {}
           override fun cancel() {}
           override fun getDataClass(): Class<InputStream> = InputStream::class.java
           override fun getDataSource(): DataSource = DataSource.LOCAL
       }
   }
   

3. 注册ModelLoader
   在Glide的配置类中注册自定义的ModelLoader：

   @GlideModule
   class MyGlideModule : AppGlideModule() {
       override fun registerComponents(context: Context, glide: Glide, registry: Registry) {
           registry.append(PreloadCacheModel::class.java, InputStream::class.java, PreloadCacheModelLoader(context))
       }
   }
   

4. 执行预加载
   照片上传完成后，用自定义Model触发预加载：

   val localFile = File(localFilePath)
   val preloadModel = PreloadCacheModel(localFile, remoteUri)
   
   Glide.with(context)
       .load(preloadModel)
       .apply(requestOptions) // 和实际加载远程URI的Options完全一致
       .preload()
   

关键注意事项 #

• 保持Options完全一致：预填充时的RequestOptions必须和后续加载远程URI时的完全相同（包括缓存策略、尺寸、转换操作等），否则缓存键不匹配，预填充的缓存不会生效。
• 异常处理：要处理本地文件不存在、缓存写入失败等异常情况，避免应用崩溃。
• 缓存更新：如果后续远程URI的内容更新了，记得清理对应的Glide缓存，避免加载旧内容。

内容的提问来源于stack exchange，提问作者G. Blake Meike