Spring HttpInterface接口@Cacheable告警原因、修复及功能排查咨询

问题背景 #

使用Spring HttpInterface实现HTTP调用并通过@Cacheable缓存结果，测试功能正常但收到Spring告警：Spring doesn't recommend to annotate interface methods with @Cache* annotation，以下是问题分析与解决方案：

一、告警原因

• Spring缓存注解（@Cacheable等）基于动态代理实现，而HttpInterface的实现类是Spring通过HttpServiceProxyFactory生成的专用代理，核心职责是处理HTTP请求的序列化、发送与响应解析，和Spring缓存代理的逻辑设计不兼容。
• 当前缓存看似生效，本质是Spring在HttpInterface代理之上叠加了一层缓存代理，这种双重代理场景并非Spring的标准设计用法，可能引发不可预期问题，因此Spring抛出告警提示。

二、修复方案

将缓存逻辑从HttpInterface方法上迁移到调用它的业务服务层（ReportService的getReport方法），既符合Spring缓存设计规范，也能实现缓存开销极大的HTTP调用的目标：

修改后的ReportService代码：

@Service
class ReportService {

    private final ReportHttpInterface reportHttpInterface;
    private final ReportLocalDecryptService reportLocalDecryptService;

    ReportService(ReportHttpInterface reportHttpInterface, ReportLocalDecryptService reportLocalDecryptService) {
        this.reportHttpInterface = reportHttpInterface;
        this.reportLocalDecryptService = reportLocalDecryptService;
    }

    @Cacheable("report") // 迁移至此处
    Report getReport(String name) {
        String encryptedReport = reportHttpInterface.getReport(name);
        String decryptedReport = reportLocalDecryptService.decryptWithLocalKey(encryptedReport);
        return new Report(decryptedReport);
    }
}

同时移除HttpInterface上的@Cacheable注解：

@HttpExchange(accept = MediaType.APPLICATION_JSON_VALUE)
interface ReportHttpInterface {

    @GetExchange("/api/veryexpensivecall/report")
    String getReport(@RequestParam String name);

}

该方案的优势：

• 遵循Spring缓存标准用法，避免双重代理的潜在冲突
• 缓存最终的Report对象，减少重复解密操作的开销（若业务需缓存加密字符串，也可单独在reportHttpInterface.getReport调用处做缓存处理）

三、是否存在未发现的功能异常

当前测试虽正常，但存在以下潜在问题：

• 代理冲突：HttpInterface代理与缓存代理的优先级、执行顺序，在叠加事务或其他AOP注解的场景下可能混乱，导致缓存失效或HTTP请求重复发送
• 缓存键生成异常：HttpInterface方法参数在缓存代理中可能无法被正确识别，若后续添加复杂参数，易出现缓存键生成错误
• 监控统计失真：Caffeine的缓存统计无法正确关联真实HTTP调用，因缓存代理拦截在HttpInterface代理之前，统计的命中/失效数据与实际HTTP请求次数不匹配

按修复方案调整后，上述潜在问题均可解决，缓存逻辑会更稳定可靠。

内容的提问来源于stack exchange，提问作者PatPanda