guava cache 是一个适合中小型 java 项目的本地缓存实现。1. 它提供自动加载、过期策略、大小限制等功能;2. 使用简单,api 简洁,无需引入外部服务;3. 支持基于时间与访问的过期机制、条目数量或权重控制、统计信息及异步刷新;4. 创建时通过 cachebuilder 构建实例并配置策略;5. 可结合 spring 的 @cacheable 注解提升开发效率;6. 不适合大数据量或跨 jvm 场景。

用Java实现缓存的方式有很多,其中 Google 的 Guava 库提供的 Guava Cache 是一个轻量级、功能丰富、使用方便的本地缓存实现,非常适合中小型项目使用。它不仅支持自动加载、过期策略、大小限制等常用功能,而且 API 简洁,上手快。

为什么选择 Guava Cache?
在 Java 项目中,如果只是想做一个本地缓存,不需要引入像 Redis 这样的外部服务,Guava Cache 是一个不错的选择。相比自己写 Map 缓存,它提供了:
- 自动过期机制(基于时间和访问时间)
- 缓存大小控制(基于条目数量或权重)
- 自动加载和刷新功能
- 统计信息支持(命中率等)
适合用于减少重复计算、减轻数据库压力等场景。
立即学习“Java免费学习笔记(深入)”;

如何添加依赖?
使用 Guava Cache 前,需要先在项目中引入 Guava 库。如果你用的是 Maven,可以在 pom.xml 中添加如下依赖:
com.google.guava guava 31.1-jre
Gradle 用户可以这样加:

implementation 'com.google.guava:guava:31.1-jre'
注意:Guava 分 JRE 和 Android 版本,Java 项目一般选 JRE 版本。
怎么创建和使用一个缓存?
Guava Cache 提供了 CacheBuilder 来构建缓存实例。下面是一个简单的例子:
多奥淘宝客程序免费版拥有淘宝客站点的基本功能,手动更新少,管理简单等优点,适合刚接触网站的淘客们,或者是兼职做淘客们。同样拥有VIP版的模板引擎技 术、强大的文件缓存机制,但没有VIP版的伪原创跟自定义URL等多项创新的搜索引擎优化技术,除此之外也是一款高效的API数据系统实现无人值守全自动 化运行的淘宝客网站程序。4月3日淘宝联盟重新开放淘宝API申请,新用户也可使用了
import com.google.common.cache.CacheBuilder;
import com.google.common.cache.CacheLoader;
import com.google.common.cache.LoadingCache;
import java.util.concurrent.TimeUnit;
public class CacheExample {
public static void main(String[] args) throws Exception {
LoadingCache cache = CacheBuilder.newBuilder()
.maximumSize(100) // 最多缓存100个条目
.expireAfterWrite(10, TimeUnit.MINUTES) // 写入后10分钟过期
.build(new CacheLoader() {
@Override
public String load(String key) throws Exception {
// 模拟从数据库加载数据
return "value-for-" + key;
}
});
System.out.println(cache.get("key1")); // 第一次会加载
System.out.println(cache.get("key1")); // 第二次从缓存取
}
} 这里有几个关键点:
- 使用
maximumSize设置最大缓存条目数 -
expireAfterWrite设置写入后多久过期 -
CacheLoader用于定义缓存未命中时的加载逻辑
如果你不需要自动加载,也可以用 Cache 而不是 LoadingCache。
支持哪些缓存策略?
Guava Cache 支持多种缓存策略,常见的包括:
-
基于大小的限制:
maximumSize(条目数量)或maximumWeight(带权重) -
基于时间的过期:
-
expireAfterWrite:写入后多久过期 -
expireAfterAccess:最后一次访问后多久过期
-
-
显式清除:调用
invalidate(key)或invalidateAll()清除缓存 -
刷新机制:使用
refresh方法触发异步重新加载
例如,使用访问时间过期:
CacheBuilder.newBuilder()
.expireAfterAccess(5, TimeUnit.MINUTES)
.build(loader);如果你希望缓存值在过期前尽可能保持新鲜,可以结合 refreshAfterWrite 和 CacheLoader 的 reload 方法做异步刷新。
注意事项和常见问题
- Guava Cache 是本地缓存,不能跨 JVM 使用,也不适合大数据量场景。
- 如果你使用的是 Spring 项目,推荐结合
@Cacheable注解来使用 Guava Cache,这样更符合开发习惯。 - Guava Cache 的统计信息可以通过
cache.stats()获取,比如命中率、加载次数等,对性能调优有帮助。 - 如果你用的是 Java 8 以上版本,可以直接用 lambda 表达式简化代码。
Guava Cache 的功能虽然强大,但使用起来并不复杂。只要理解它的基本构建方式和策略,就能满足大部分本地缓存的需求。
基本上就这些。









