WSO2 API Manager 4.5.0启用响应缓存后Out Flow中介序列未触发

问题描述 #

WSO2内置响应缓存功能正常启用，响应能正常命中缓存，但缓存命中时Out Flow完全不执行，<log/>、<payloadFactory/>、<enrich/>、<jsonToXml/>这类中介操作全触发不了。

已观察到的现象 #

• 首次请求（缓存未命中）：Out Flow正常工作，响应能被记录、转换等；
• 后续缓存命中请求：APIResponseCacheHandler直接返回响应，绕开了Synapse中介引擎（Out Flow），既没有任何中介操作，也不会打日志，carbon.log里连响应级的活动记录都找不到。

已尝试的无效方案 #

• 自定义Cache Mediator（collector=true/false）：只有手动缓存的时候有用，缓存命中还是会跳过Out Sequence；
• 在deployment.toml里设force_message_building=true：没效果，缓存响应照样绕开中介；
• 自定义In/Out Sequences：只对非缓存响应生效。

需求目标 #

• 保留WSO2自带的响应缓存机制；
• 返回缓存响应前后还能执行指定逻辑，比如把XML转成JSON再发给客户端、记录缓存响应内容。

可行解决方案 #

方案1：自定义缓存处理拦截器 #

写一个自定义的ResponseCacheInterceptor，实现org.wso2.carbon.apimgt.gateway.handlers.cache.ResponseCacheInterceptor接口，在缓存命中后触发自定义逻辑：

1. 重写onCacheHit方法，把需要执行的中介逻辑（比如日志记录、格式转换）写到这个方法里；
2. 把自定义拦截器配置到API的缓存策略里，替换掉默认的处理逻辑。

方案2：用PostFlow扩展点（3.2.0+版本适用） #

如果用的是WSO2 API Manager 3.2.0及以上版本，可以用PostFlow的扩展能力：

• 在_xmlToJsonSequence这类自定义序列里加好缓存命中后的处理逻辑；
• 通过APIManagerExtensions配置，让PostFlow在缓存响应返回前执行指定序列，就算缓存命中也会触发这个流程。

方案3：改缓存响应的存储格式 #

首次缓存响应的时候，直接把处理完的结果（比如转成JSON后的响应）存进缓存：

• 在Out Flow里先完成格式转换、日志记录这些操作，再用Cache Mediator把最终处理好的响应存进缓存；
• 后续缓存命中时直接返回已经处理好的响应，不用再走Out Flow逻辑。

内容的提问来源于stack exchange，提问作者Kürşat Oltulu