配置Java使用Guava工具库方法

本文详解了在Java项目中正确配置和使用Google Guava工具库的核心实践：强调直接在pom.xml中声明`com.google.guava:guava:33.2.1-jre`（不可省略`-jre`后缀），避免旧版本冲突与classifier误用；明确指出Guava自32.0.0-jre起已弃用`com.google.common.base.Optional`，必须全面迁移到`java.util.Optional`以规避编译失败和类型不兼容风险；深入剖析Guava Cache常见内存泄漏陷阱，强调必须显式配置过期策略、合理选用引用类型（如`weakKeys()`）；同时厘清`ImmutableList`的适用边界——仅用于创建即不可变的场景，切勿滥用导致运行时异常，并对比其与`Lists.newArrayList()`在性能、语义和调试表现上的关键差异，助你写出更健壮、高效且可维护的Guava代码。

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 的 里锁死版本，避免子模块各自声明导致实际加载的不是你写的那个版本

为什么 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) 就万事大吉。

• 没设 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。

理论要掌握，实操不能落！以上关于《配置Java使用Guava工具库方法》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！