3行代码解决90%图片缓存问题：Glide自定义缓存键完全指南
项目地址: https://gitcode.com/gh_mirrors/gl/glide 你是否遇到过这些图片加载痛点？
- 同一URL因参数不同需重新加载
- 用户头像更新后仍显示旧图
- 多尺寸图片缓存占用重复空间
Glide作为Android生态最流行的图片加载库，其默认缓存机制虽然强大，但在复杂业务场景下往往需要精细化控制。本文将通过3个实战案例，教你如何通过自定义缓存键（Cache Key）解决上述问题，让图片加载既省流量又不占空间。
缓存键工作原理：3个核心接口
Glide的缓存系统基于"键值对"设计，理解以下接口是自定义缓存的基础：
Key接口：缓存键的核心定义
Key.java定义了缓存键的标准，所有自定义缓存键必须实现：
updateDiskCacheKey()：将关键信息添加到消息摘要equals()和hashCode()：确保键的唯一性判断
DiskCache接口：缓存操作入口
DiskCache.java提供缓存读写能力，其中：
get(Key key)：通过键获取缓存文件put(Key key, Writer writer)：写入缓存时关联键值
缓存键生成流程
实战案例1：URL参数变化时强制刷新
业务场景：用户头像URL不变但内容更新时，需要立即显示新头像而非旧缓存。
实现自定义缓存键
public class AvatarCacheKey implements Key {
private final String userId;
private final String baseUrl;
public AvatarCacheKey(String userId, String baseUrl) {
this.userId = userId;
this.baseUrl = baseUrl;
}
@Override
public void updateDiskCacheKey(@NonNull MessageDigest messageDigest) {
messageDigest.update((userId + baseUrl).getBytes(CHARSET));
}
@Override
public boolean equals(Object o) {
if (this == o) return true;
if (o == null || getClass() != o.getClass()) return false;
AvatarCacheKey that = (AvatarCacheKey) o;
return Objects.equals(userId, that.userId) &&
Objects.equals(baseUrl, that.baseUrl);
}
@Override
public int hashCode() {
return Objects.hash(userId, baseUrl);
}
}
在Glide中应用
Glide.with(context)
.load(avatarUrl)
.apply(new RequestOptions()
.signature(new ObjectKey(new AvatarCacheKey(userId, avatarUrl))))
.into(imageView);
实战案例2：多尺寸图片共享缓存
业务场景：同一张图片在列表页(200dp)和详情页(400dp)使用不同尺寸，默认会生成两个缓存文件。
解决方案：忽略尺寸参数
public class SizeIgnoringCacheKey implements Key {
private final String url;
public SizeIgnoringCacheKey(String url) {
this.url = url;
}
@Override
public void updateDiskCacheKey(@NonNull MessageDigest messageDigest) {
// 仅使用URL生成缓存键，忽略尺寸信息
messageDigest.update(url.getBytes(CHARSET));
}
// equals和hashCode实现略...
}
实战案例3：带时效性的缓存控制
业务场景：商品详情页图片需每小时刷新一次，避免显示过期促销信息。
结合时间戳的缓存键
public class TimeBasedCacheKey implements Key {
private final String url;
private final long timestamp; // 按小时取整
public TimeBasedCacheKey(String url) {
this.url = url;
this.timestamp = System.currentTimeMillis() / (3600 * 1000);
}
@Override
public void updateDiskCacheKey(@NonNull MessageDigest messageDigest) {
messageDigest.update((url + timestamp).getBytes(CHARSET));
}
// equals和hashCode实现略...
}
缓存键调试与最佳实践
缓存目录结构
Glide默认缓存路径：/data/data/包名/cache/image_manager_disk_cache/，每个缓存键对应：
- 一个文件（实际缓存内容）
- 一个.meta文件（缓存元数据）
调试工具
通过DiskLruCache查看缓存内容：
// 示例代码来自samples/gallery模块
File cacheDir = new File(context.getCacheDir(), "image_manager_disk_cache");
DiskLruCache cache = DiskLruCache.open(cacheDir, 1, 1, DiskCache.Factory.DEFAULT_DISK_CACHE_SIZE);
性能优化建议
- 避免复杂计算：
updateDiskCacheKey()在主线程执行，避免耗时操作 - 控制键唯一性：过于简单导致缓存冲突，过于复杂浪费存储空间
- 合理使用签名：优先使用
ObjectKey包装简单对象，避免重复实现Key接口
总结与进阶
自定义缓存键是解决Glide缓存问题的终极方案，通过实现Key接口，我们可以：
- 精确控制缓存失效策略
- 减少重复缓存节省空间
- 实现业务相关的缓存逻辑
进阶学习可参考：
- Glide官方文档：README.md
- 缓存实现源码：LruResourceCache.java
- 完整示例：samples/gallery
通过本文介绍的方法，你可以让Glide缓存行为完全适配业务需求，既保证图片加载速度，又避免缓存相关的各种"问题"。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
