LoadingCache<K, V>是Guava中带自动加载能力的泛型缓存接口，K和V必须为具体类型（如String、User），不可用原始类型或泛型占位符；键K需不可变且重写equals/hashCode，值V建议不可变或线程安全；泛型声明须贯穿CacheBuilder链式调用，类型不匹配将编译失败。
Guava 的 LoadingCache<K, V> 本质就是一个带自动加载能力的泛型缓存接口，构建时必须明确指定键（K）和值（V）的具体类型，不能用原始类型或泛型占位符直接实例化。
泛型类型必须在 build 前确定
你不能写 LoadingCache<K, V> 这样的“泛型模板”去运行——JVM 不支持擦除后的泛型类型直接构造。实际使用时，K 和 V 必须是具体类，比如 String、Long、User、List<Order> 等。
- 键类型 K 通常选不可变、重写了
equals()和hashCode()的类，如String、Long、UUID - 值类型 V 可以是任意引用类型，但建议是线程安全或不可变对象；若需存储集合，推荐用
ImmutableList或包装为不可变视图 - 泛型声明要贯穿整个链式调用：从
CacheBuilder.newBuilder()到build(new CacheLoader<K, V>(){...})，所有地方 K/V 类型必须一致
正确写法示例（以 String → User 为例）
下面这段代码定义了一个缓存：用用户 ID（String）查用户对象（User），过期时间 10 分钟，最大容量 1000：
deep-java-review
下载
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
LoadingCache<String, User> userCache = CacheBuilder.newBuilder()
.maximumSize(1000)
.expireAfterWrite(10, TimeUnit.MINUTES)
.build(new CacheLoader<String, User>() {
@Override
public User load(String userId) throws Exception {
return userService.findById(userId); // 实际数据加载逻辑
}
});
注意：CacheLoader<String, User> 中的泛型必须与 LoadingCache<String, User> 完全匹配，否则编译失败。
立即学习“Java免费学习笔记（深入）”；
常见泛型组合与注意事项
-
LoadingCache<Long, List<Product>>：键是商品分类 ID，值是该分类下商品列表；建议返回ImmutableList.copyOf(list)避免外部修改影响缓存一致性 -
LoadingCache<String, Optional<Config>>：适合可能为空的场景，load()返回Optional.empty()表示查无此配置，避免 null 值污染缓存 - 避免使用可变集合作为 V，例如
ArrayList或HashMap—— 外部修改会同步反映到缓存中，引发并发问题或脏数据 - 若需多类型缓存，不要强行复用同一泛型变量，应分别定义不同缓存实例，如
LoadingCache<String, User>和LoadingCache<Long, Order>
泛型擦除不影响功能，但影响编译安全
Java 运行时泛型已擦除，但编译器靠泛型声明做类型检查。比如调用 userCache.get("123")，返回值自动是 User 类型，无需强制转型；如果泛型写错（如声明成 LoadingCache<String, String> 却加载 User），编译阶段就会报错，提前拦截类型风险。
