直接在pom.xml中声明com.google.guava:guava:33.2.1-jre即可,无需classifier;注意避免旧版本冲突、统一dependencyManagement管理;Guava Optional自32.0.0-jre起已弃用,须迁移到java.util.Optional;Guava Cache需配置淘汰策略防内存泄漏;ImmutableList适用于创建即固定的场景。

Guava 依赖怎么写进 pom.xml 才不冲突
直接用最新稳定版 com.google.guava:guava,别碰 guava-jre 或 guava-android —— 大多数 Java 后端项目要的是 JRE 版本,但 Maven 中只写 guava 就够了,它已自动适配 JDK 8+。
常见错误是抄到旧版(比如 19.0)或加了 classifier,结果 ImmutableList.of() 编译报错、Optional 和 JDK 自带的冲突。Maven 里只要这一段:
<dependency> <groupId>com.google.guava</groupId> <artifactId>guava</artifactId> <version>33.2.1-jre</version> </dependency>
- 版本号末尾的
-jre不能省,这是区分 Android 兼容版的关键标识 - 如果项目用了 Spring Boot 3.x + JDK 17,确认没意外引入
guava:29.0-jre等低版本——老版本不支持jdk17+的sealed类校验,运行时可能抛VerifyError - 多个模块共用 Guava 时,统一在父
pom.xml的<dependencyManagement>里锁死版本,避免子模块各自声明导致实际加载的不是你写的那个版本
为什么 Optional 和 com.google.common.base.Optional 不能混用
Guava 的 Optional 在 guava 32.0.0-jre 起已被标记为 @Deprecated,官方明确要求迁移到 JDK 8+ 的 java.util.Optional。这不是风格偏好问题,而是类型不兼容:两者无继承关系,传参或返回时编译直接失败。
- 旧代码里还在用
Optional.fromNullable(x)?立刻换成Optional.ofNullable(x) -
FluentIterable、Iterables等类里大量返回Optional,升级后需同步改调用链,否则map()后接不上 JDK 的orElse() - 如果必须保留 Guava
Optional(比如维护老 SDK),请确保全模块都用同一套,且禁止和java.util.Optional出现在同一个方法签名里
CacheBuilder 配置内存泄漏的三个典型写法
Guava Cache 默认是强引用 key/value,不做清理就容易 OOM。不是加了 maximumSize(1000) 就万事大吉。
立即学习“Java免费学习笔记(深入)”;
- 没设
expireAfterWrite或expireAfterAccess:缓存项永远不淘汰,size 限制只在 put 时触发驱逐,但已有对象仍驻留堆中 - key 是匿名内部类或 Lambda:它们隐式持外部类引用,导致整个 Activity/Service 实例无法回收(Android 场景);Java SE 里也容易让 DAO 对象被缓存间接持有
- 用了
weakKeys()却没配weakValues()或softValues():key 可能被回收,value 还牢牢占着内存,反而更难预测生命周期
推荐写法:CacheBuilder.newBuilder().maximumSize(1000).expireAfterWrite(10, TimeUnit.MINUTES).weakKeys().build(...) —— 至少保证 key 不阻止 GC,再配合业务逻辑控制 value 生命周期。
从 Lists.newArrayList() 到 ImmutableList.of() 的实际取舍
别无脑替换成 ImmutableList。它适合配置、枚举值、API 响应体等「创建即固定」的场景;但若后续还要 add()、remove(),强行用不可变集合只会让你多写三行 new ArrayList(immutableList)。
-
Lists.newArrayList()返回的是ArrayList,可变、线程不安全、无额外封装开销 -
ImmutableList.of("a", "b")在元素 ≤ 5 时走紧凑实现(无数组分配),性能略优;但ImmutableList.copyOf(list)会深拷贝,大数据量时注意 GC 压力 - IDEA 里 Ctrl+Click 进去看到
ImmutableList构造器是private,说明它不鼓励运行时构造,更适合做常量定义
真正容易被忽略的是:ImmutableList 的 equals() 和 hashCode() 行为与 ArrayList 一致,但它的 toString() 输出格式一样,调试时看不出区别,误以为可变,结果修改时报 UnsupportedOperationException。


















