Caffeine缓存值存储失效问题解析与最佳实践

大辰姑娘_7446

大辰姑娘_7446

2025-11-09

532人浏览

原创

Caffeine缓存值存储失效问题解析与最佳实践

本文旨在解决caffeine缓存中值存储后无法正确获取(返回null)的常见问题。通过深入分析`weakkeys()`、`weakvalues()`以及缓存实例的作用域,文章揭示了导致值失效的核心原因,并提供了将缓存声明为`static final`并移除弱引用配置的解决方案。教程将详细阐述其原理,并给出示例代码,帮助开发者构建稳定可靠的caffeine缓存。

理解Caffeine缓存值失效问题

在使用Caffeine构建本地缓存时,开发者可能会遇到一个令人困惑的问题:即使通过put()方法存储了值,随后尝试通过getIfPresent()获取时却返回null。这通常发生在以下场景中:

import com.github.benmanes.caffeine.cache.Cache;
import com.github.benmanes.caffeine.cache.Caffeine;
import java.util.concurrent.TimeUnit;

public class MyCacheService {

    // 假设这是一个普通的实例字段
    private Cache<long smsdata> codeCache = Caffeine.newBuilder()
            .expireAfterWrite(24, TimeUnit.HOURS)
            .weakKeys() // 弱引用键
            .weakValues() // 弱引用值
            .build();

    public void storeSmsData(Long id, int currentSendCount) {
        SmsData data = new SmsData();
        data.setSendCount(++currentSendCount);
        data.setCheckCount(0);
        codeCache.put(id, data);
        System.out.println("Stored data for id: " + id + ", data: " + data);
    }

    public SmsData retrieveSmsData(Long id) {
        SmsData data = codeCache.getIfPresent(id);
        System.out.println("Retrieved data for id: " + id + ", data: " + data);
        return data;
    }

    // 模拟数据类
    static class SmsData {
        int sendCount;
        int checkCount;

        public int getSendCount() { return sendCount; }
        public void setSendCount(int sendCount) { this.sendCount = sendCount; }
        public int getCheckCount() { return checkCount; }
        public void setCheckCount(int checkCount) { this.checkCount = checkCount; }

        @Override
        public String toString() {
            return "SmsData{sendCount=" + sendCount + ", checkCount=" + checkCount + '}';
        }
    }

    public static void main(String[] args) throws InterruptedException {
        MyCacheService service = new MyCacheService();
        Long testId = 123L;

        service.storeSmsData(testId, 1);
        // 短暂等待,模拟GC或线程切换
        // Thread.sleep(100); 

        SmsData retrievedData = service.retrieveSmsData(testId);
        if (retrievedData == null) {
            System.out.println("Error: Data for id " + testId + " was null!");
        }
    }
}</long>

在上述代码中,尽管我们调用了put()方法,但getIfPresent()很可能返回null。这通常是由两个主要因素导致的:弱引用配置和缓存实例的生命周期。

弱引用(Weak References)的陷阱

Caffeine提供了weakKeys()和weakValues()方法,允许缓存使用弱引用来持有键和值。在Java中,弱引用是一种特殊的引用类型,它不会阻止垃圾收集器回收其引用的对象。这意味着,如果一个对象只被弱引用所引用,并且没有其他强引用指向它,那么垃圾收集器在下一次运行时就会回收这个对象。

  • weakKeys(): 如果键只被缓存弱引用,并且没有其他强引用指向该键对象,那么该键及其对应的值可能会被垃圾回收。
  • weakValues(): 如果值只被缓存弱引用,并且没有其他强引用指向该值对象,那么该值可能会被垃圾回收。

对于大多数缓存场景,我们期望缓存能够“强”持有其存储的键和值,直到它们因过期策略(如expireAfterWrite)或容量限制而被主动驱逐。使用弱引用通常是为了实现内存敏感的缓存,例如,当缓存的目的是作为其他地方已经强引用的对象的“影子”副本,或者你希望当内存紧张时,缓存能够自动释放那些不再被应用程序其他部分使用的对象。然而,如果不理解其含义,这会导致缓存行为与预期不符。

缓存实例的生命周期

如果Cache实例本身是一个普通的对象字段(如上述示例中的private Cache codeCache),那么它会随着其所在对象的生命周期而存在。如果包含Cache的MyCacheService对象在应用程序中被频繁创建和销毁,或者该对象本身被垃圾回收,那么其内部的Cache实例也会随之消失,导致所有存储的数据丢失。

对于一个应用程序级别的缓存,我们通常希望它在应用程序的整个生命周期内都保持活跃,并且其内部数据不会因为缓存实例本身被回收而丢失。

解决方案:static final与移除弱引用

解决上述问题的方法相对直接:确保缓存实例的生命周期与应用程序保持一致,并移除不必要的弱引用配置。

Capture and search AI coding sessions alongside Git history with Entire CLI
Capture and search AI coding sessions alongside Git history with Entire CLI

在提交旁边记录AI编码会话,以便代理程序可以恢复代码更改的原因、从检查点恢复以及干净地交接工作。

下载

1. 将缓存声明为 static final

将Cache实例声明为static final具有以下优点:

  • 静态(static): 确保codeCache是类级别的,而不是实例级别的。这意味着无论创建多少个MyCacheService对象,都只有一个codeCache实例。这对于应用程序范围的缓存至关重要。
  • 最终(final): 确保codeCache引用一旦初始化后就不会再改变。这增强了代码的健壮性和可预测性。

通过这种方式,codeCache实例将伴随应用程序的整个生命周期,直到应用程序终止,从而避免了缓存实例本身被垃圾回收的问题。

2. 移除 weakKeys() 和 weakValues()

除非有明确的、经过深思熟虑的理由需要弱引用行为,否则应移除weakKeys()和weakValues()配置。默认情况下,Caffeine会使用强引用来持有键和值,这正是大多数缓存场景所期望的行为。这样,只要缓存本身存在,并且键值对没有因过期或容量限制而被驱逐,它们就会被强引用持有,不会被垃圾回收。

修正后的代码示例

import com.github.benmanes.caffeine.cache.Cache;
import com.github.benmanes.caffeine.cache.Caffeine;
import java.util.concurrent.TimeUnit;

public class MyCacheService {

    // 修正:声明为 static final,并移除 weakKeys() 和 weakValues()
    private static final Cache<long smsdata> codeCache = Caffeine.newBuilder()
            .expireAfterWrite(24, TimeUnit.HOURS) // 保持过期策略
            // .weakKeys() // 移除此行
            // .weakValues() // 移除此行
            .build();

    public void storeSmsData(Long id, int currentSendCount) {
        SmsData data = new SmsData();
        data.setSendCount(++currentSendCount);
        data.setCheckCount(0);
        codeCache.put(id, data);
        System.out.println("Stored data for id: " + id + ", data: " + data);
    }

    public SmsData retrieveSmsData(Long id) {
        SmsData data = codeCache.getIfPresent(id);
        System.out.println("Retrieved data for id: " + id + ", data: " + data);
        return data;
    }

    // 模拟数据类
    static class SmsData {
        int sendCount;
        int checkCount;

        public int getSendCount() { return sendCount; }
        public void setSendCount(int sendCount) { this.sendCount = sendCount; }
        public int getCheckCount() { return checkCount; }
        public void setCheckCount(int checkCount) { this.checkCount = checkCount; }

        @Override
        public String toString() {
            return "SmsData{sendCount=" + sendCount + ", checkCount=" + checkCount + '}';
        }
    }

    public static void main(String[] args) throws InterruptedException {
        // 现在即使创建多个MyCacheService实例,它们也共享同一个静态缓存
        MyCacheService service1 = new MyCacheService();
        MyCacheService service2 = new MyCacheService();
        Long testId = 123L;

        service1.storeSmsData(testId, 1);

        // 现在从任何实例获取都应该成功
        SmsData retrievedData = service2.retrieveSmsData(testId);
        if (retrievedData == null) {
            System.out.println("Error: Data for id " + testId + " was null!");
        } else {
            System.out.println("Success: Data for id " + testId + " retrieved: " + retrievedData);
        }
    }
}</long>

通过上述修改,codeCache现在是一个应用程序级别的、强引用的缓存,其存储的值将按照expireAfterWrite(24, TimeUnit.HOURS)的策略进行过期,而不是被垃圾回收器随意清除。

最佳实践与注意事项

  1. 缓存作用域的选择:
    • 应用程序级缓存:对于需要在整个应用程序生命周期内共享和持久化的数据,使用static final声明缓存是最佳实践。
    • 请求级/会话级缓存:如果缓存仅用于特定请求或会话的短暂生命周期,则可以将其作为实例字段,但需确保其生命周期管理得当,避免内存泄漏或过早回收。
  2. 弱引用的适用场景:
    • 内存敏感缓存:当缓存的对象同时在应用程序的其他地方被强引用,并且你希望在内存紧张时,缓存能够自动释放这些对象,而无需显式清除时,可以考虑使用弱引用。例如,缓存对大型图片或计算结果的引用,这些图片或结果可能在其他地方有强引用。
    • 避免内存泄漏:在某些复杂的场景中,弱引用可以帮助打破循环引用,从而防止内存泄漏。
    • 重要提示:在决定使用weakKeys()或weakValues()之前,请务必充分理解其对缓存行为和垃圾回收的影响。对于大多数常规数据缓存,强引用是更安全和可预测的选择。
  3. Caffeine的线程安全性:Caffeine缓存是线程安全的,因此无需额外的同步机制即可在多线程环境中安全使用。
  4. 过期策略与容量限制:除了本教程讨论的弱引用问题,还应根据业务需求合理配置缓存的过期策略(expireAfterWrite、expireAfterAccess)和容量限制(maximumSize),以有效管理内存和数据的新鲜度。
  5. 缓存穿透与雪崩:在设计缓存时,还需考虑缓存穿透(查询不存在的数据导致每次都回源)、缓存击穿(热点数据失效导致大量请求回源)和缓存雪崩(大量缓存同时失效导致系统崩溃)等问题,并采取相应的策略(如布隆过滤器、热点数据永不过期、错峰过期等)进行防御。

总结

Caffeine是一个高性能的本地缓存库,但其强大的配置选项也需要开发者深入理解才能正确使用。当遇到Caffeine缓存值存储后无法获取的问题时,首要检查的便是缓存实例的作用域(是否为static final)以及是否错误地使用了weakKeys()或weakValues()。通过将应用程序级缓存声明为static final并移除不必要的弱引用配置,可以确保缓存数据按照预期持久化,从而构建稳定可靠的缓存系统。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

2023.09.22

569

3

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

2024.03.01

1698

6

线程和进程的区别
线程和进程的区别

线程和进程的区别:线程是进程的一部分,用于实现并发和并行操作,而线程共享进程的资源,通信更方便快捷,切换开销较小。本专题为大家提供线程和进程区别相关的各种文章、以及下载和课程。

2023.08.10

4958

6

Python 多线程与异步编程实战
Python 多线程与异步编程实战

本专题系统讲解 Python 多线程与异步编程的核心概念与实战技巧,包括 threading 模块基础、线程同步机制、GIL 原理、asyncio 异步任务管理、协程与事件循环、任务调度与异常处理。通过实战示例,帮助学习者掌握 如何构建高性能、多任务并发的 Python 应用。

2025.12.24

1389

20

java多线程相关教程合集
java多线程相关教程合集

本专题整合了java多线程相关教程,阅读专题下面的文章了解更多详细内容。

2026.01.21

463

30

C++多线程相关合集
C++多线程相关合集

本专题整合了C++多线程相关教程,阅读专题下面的的文章了解更多详细内容。

2026.01.21

599

24

C# 多线程与异步编程
C# 多线程与异步编程

本专题深入讲解 C# 中多线程与异步编程的核心概念与实战技巧,包括线程池管理、Task 类的使用、async/await 异步编程模式、并发控制与线程同步、死锁与竞态条件的解决方案。通过实际项目,帮助开发者掌握 如何在 C# 中构建高并发、低延迟的异步系统,提升应用性能和响应速度。

2026.02.06

449

20

C++多线程并发控制与线程安全设计实践
C++多线程并发控制与线程安全设计实践

本专题围绕 C++ 在高性能系统开发中的并发控制技术展开,系统讲解多线程编程模型与线程安全设计方法。内容包括互斥锁、读写锁、条件变量、原子操作以及线程池实现机制,同时结合实际案例分析并发竞争、死锁避免与性能优化策略。通过实践讲解,帮助开发者掌握构建稳定高效并发系统的关键技术。

2026.03.16

293

22

Java 多线程与并发编程实战
Java 多线程与并发编程实战

深入讲解 Java 并发编程体系,涵盖 Thread / Runnable / Callable 线程创建方式、线程生命周期与状态转换、synchronized 同步锁与 Lock/ReentrantLock 显式锁、volatile 可见性保证、ThreadPool 线程池配置与调优(核心参数/拒绝策略)、JUC 并发工具类(CountDownLatch/CyclicBarrier/Semaphore/ConcurrentHashMa

2026.04.17

409

31

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习