spring 的 `@cacheable` 默认不具备只读模式，但可通过自定义 `cachemanager` 和 `cache` 装饰器实现微服务级缓存读写分离：让一个服务仅读取缓存而不更新，彻底规避 `unless` 或 `condition` 的无效尝试。
在分布式微服务架构中，常需对同一缓存区域实施差异化访问策略——例如，服务 A 负责业务数据写入并同步更新缓存，而服务 B 仅作为只读消费者，严禁任何写操作（如 put、evict、clear），以避免缓存污染或并发一致性风险。遗憾的是，Spring 原生注解（如 @Cacheable）不支持声明式只读语义：condition="false" 或 unless="true" 会导致整个缓存逻辑被跳过（即既不读也不写），而非“只读不写”。
✅ 正确解法：装饰器模式实现只读缓存层
核心思路是 不修改业务代码，而是通过 SPI 扩展 Spring 缓存抽象层，利用 CacheManager → Cache 的委托链，在运行时将真实缓存（如 RedisCache）包装为“只读代理”。
步骤一：定义只读 Cache 实现
public class ReadOnlyCache implements Cache {
private final Cache delegate;
public ReadOnlyCache(Cache delegate) {
this.delegate = Objects.requireNonNull(delegate);
}
@Override
public String getName() {
return delegate.getName();
}
@Override
public Object getNativeCache() {
return delegate.getNativeCache();
}
@Override
public ValueWrapper get(Object key) {
return delegate.get(key); // ✅ 允许读取
}
@Override
public T get(Object key, Class type) {
return delegate.get(key, type);
}
@Override
public void put(Object key, Object value) {
// ❌ 静默丢弃写入（也可抛 UnsupportedOperationException）
}
@Override
public void putIfAbsent(Object key, Object value) {
// 静默丢弃
}
@Override
public void evict(Object key) {
// 静默丢弃
}
@Override
public void clear() {
// 静默丢弃
}
} ⚠️ 注意：get() 等读方法必须透传调用，而所有写方法（put, evict, clear 等）应空实现或记录告警，确保零副作用。
步骤二：创建只读 CacheManager 包装器
public class ReadOnlyCacheManager implements CacheManager {
private final CacheManager delegate;
public ReadOnlyCacheManager(CacheManager delegate) {
this.delegate = Objects.requireNonNull(delegate);
}
@Override
public Cache getCache(String name) {
Cache cache = delegate.getCache(name);
return cache != null ? new ReadOnlyCache(cache) : null;
}
@Override
public Collection getCacheNames() {
return delegate.getCacheNames();
}
} 该类拦截所有 getCache() 调用，自动将底层缓存（如 RedisCacheManager 创建的 RedisCache）转为 ReadOnlyCache 实例。
步骤三：按环境动态注入只读缓存管理器
使用 @Profile 实现部署时切换，避免硬编码分支：
@Configuration
@Profile("read-only-microservice") // 启动时添加 -Dspring.profiles.active=read-only-microservice
public class ReadOnlyCachingConfiguration {
@Bean
public BeanPostProcessor readOnlyCacheManagerDecorator() {
return new BeanPostProcessor() {
@Override
public Object postProcessAfterInitialization(Object bean, String beanName) {
if (bean instanceof CacheManager) {
return new ReadOnlyCacheManager((CacheManager) bean);
}
return bean;
}
};
}
}✅ 优势：
- 完全兼容 Spring Boot 自动配置（无需手动声明 RedisCacheManager）；
- 与 @Cacheable、@CacheEvict 等注解无缝协作；
- 写操作被静默拦截，业务无感知，日志可追加审计（如 log.warn("Write attempt blocked on read-only cache [{}]", name)）；
- 支持多缓存提供者（Redis/Hazelcast/Caffeine），只需统一装饰 CacheManager。
? 为什么 condition/unless 不可行？
- condition="false"：使 @Cacheable 完全跳过执行，既不查缓存也不执行方法体；
- unless="true"：方法执行后强制不缓存结果，但仍会执行原方法并可能产生副作用（如 DB 查询、HTTP 调用），且无法阻止 @CachePut/@CacheEvict。
? 进阶建议
- 若需细粒度控制（如仅某几个缓存名只读），可在 ReadOnlyCacheManager.getCache() 中加入白名单判断；
- 结合 Spring AOP 实现更灵活的拦截（如基于注解 @ReadOnlyCache），但装饰器方案更轻量、更符合 Spring 缓存 SPI 设计哲学；
- 生产环境建议在 ReadOnlyCache.put() 中抛出 UnsupportedOperationException 并捕获全局异常，便于监控误写行为。
通过这一设计，你能在不侵入业务逻辑的前提下，为微服务赋予精准的缓存访问权限控制能力——真正实现“读归读，写归写”的职责分离。
