WSO2 APIM启用响应缓存功能未生效问题咨询

以下是该问题的高频触发原因及对应修复方式，均为生产环境实测验证过的场景：

• 漏开网关全局响应缓存总开关
  多数用户仅在API Publisher的API配置页打开了响应缓存开关，忽略了网关层的全局总开关默认是关闭状态。需要到APIM安装目录下的repository/conf/deployment.toml文件中添加/确认如下配置：

  [apim.cache.responses]
  enable = true
  cache_timeout = 15
  

  修改配置后必须完全重启网关节点，该配置不支持热加载，未重启的配置不会生效。
• 请求携带了绕过缓存的标识
  WSO2网关默认会跳过带以下特征的请求，不做缓存处理：
  • 请求头包含Cache-Control: no-cache、Pragma: no-cache
  • 请求携带除Authorization之外每次请求值会变化的动态头（例如自增requestId、时间戳、随机traceId等），默认缓存键生成策略会判定为不同请求，无法命中已有缓存
  • 请求方法不是GET/HEAD，POST类请求默认不会被缓存
• 后端响应带禁止缓存的头信息
  如果模拟后端返回的响应包含以下头字段，网关会默认不缓存该响应：
  • Cache-Control: no-store/Cache-Control: private
  • Set-Cookie响应头
  • 响应状态码不是200系列的正常响应
    可以通过抓包查看首次请求的返回头，临时移除这类禁止缓存的头后再做验证。
• 缓存配置作用域未正确选择
  在Publisher页设置15秒缓存超时时，需要确认勾选了覆盖全局缓存配置选项，如果选择继承全局配置，而全局配置的缓存超时值为0，缓存功能等价于关闭状态。
• 集群部署场景下缓存未同步
  如果是多节点集群部署，需要确认所有网关节点接入了同一个分布式缓存集群（默认用Hazelcast实现），若节点间缓存数据不同步，每次请求轮询到不同节点时都会触发回源请求。

快速验证方法：

临时将后端调整为返回固定静态响应，移除所有动态响应头；用接口测试工具发送两次完全一致的GET请求，仅保留必填的Authorization认证头，若第二次请求响应头包含X-Cache: Hit from gateway cache字段，即代表缓存功能正常生效。

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