JXCache：一个 JetCache 工具集，从可观测开始

在当前团队，有几十个微服务，每个服务又有几个节点，缓存层基于 JetCache，采用 LOCAL + Redis 两级架构。

系统大部分时候运行稳定。但每隔一段时间，就会遇到一类棘手的问题：

用户反馈设备详情页数据不一致——同一设备，隔几秒刷新就交替显示在线和离线状态，而设备的状态其实一直没变。先查 Redis，数据正常。再查数据库，也正常。

问题定位到某个 Pod 的本地缓存未失效，脏数据驻留在内存中。

此时需要确认该 Pod 上这个 key 的实际缓存值。但 JetCache 本身没有提供查询本地缓存内容的接口。

逐台登录服务器打日志？四个 Pod 就需要重复操作四次。拿到日志后，还要手动对比四份输出，才能找出数据异常的节点。如果部署了二十个 Pod，这个排查过程的时间成本难以接受。

JetCache 只管「怎么缓存」，不管「缓存里有什么」。排查基本靠猜。

这个问题困扰我已久。最终在工作之余，动手写了这个工具。

JXCache。GitHub：https://github.com/yibiner/JXCache

如果你也有在用 JetCache，点个 star 收藏下，万一后续用上了呢~

它解决什么问题

JXCache 不是另一个缓存框架。它是一层 Observer + Aggregator，架在已有 JetCache 的 Spring Boot 服务之上，提供缓存可视化、跨节点对比和缓存失效能力。

工作中最常遇到的三个场景：

场景一：需要确认某个缓存 key 在线上实际存储的值。 以往的做法是加日志、改代码、重新部署。现在一个 HTTP 请求即可获取完整 value。

场景二：多 Pod 部署时，同一个 key 在各节点上的值是否一致。 以往需要逐台登录服务器手动对比。现在一个聚合请求，各节点的值并列展示，不一致的直接高亮标记。

场景三：发现脏数据需要立即清除。 以往只能修改 TTL 等待过期，或重启服务。现在调用一个接口，指定 key，即时失效，支持单节点或全节点操作。

下面逐一说明实现思路。

Observer：单节点缓存可视化

Observer 是部署在每个业务服务上的观测端，本质是一组 REST 接口。

设计的核心原则：查看缓存内容，但不能因为观测行为本身而改变缓存状态。

这里有一个需要注意的问题。JetCache 的 MultiLevelCache 在读取时会触发回填机制——L0 未命中则查询 L1，L1 有值时自动写回 L0。如果通过 JetCache 的 API 读取缓存，恰好 L0 已过期，它会从 Redis 回填一条数据。此时你无法判断这条数据是原本就存在，还是被观测行为触发的回填。

因此 Observer 绕开了 JetCache 的代理层，直接读取 Caffeine 的内部数据结构。多了一些内省代码，但保证了观测的纯净性——查看缓存不会影响缓存。

三个核心接口：

列出缓存 key

支持前缀过滤、分页和分片。当缓存中存在大量 key 时，通过分片查询避免单次返回数据量过大。

查看单个 key 的完整值

不做截断处理，存储什么就返回什么。

失效某个 key

即时生效，无需等待 TTL 过期或重启服务。