Apache实现外部API高性能缓存需同时满足：启用mod_proxy_http、mod_cache、mod_cache_disk（及mod_headers可选）、CacheEnable路径与ProxyPass路径一致、后端响应含合法Cache-Control且无阻断头。
Apache 中用 mod_proxy 实现对外部 API 的高性能缓存，核心不是单纯开启代理，而是构建“代理 + 缓存 + 后端协同”的闭环。它依赖三个关键条件：代理链路打通、缓存模块正确加载与配置、API 响应头明确允许缓存。缺一不可，否则几乎全是 X-Cache: MISS。
必须启用的模块组合
仅 mod_proxy 无法缓存 —— 它只负责转发。真正落盘或存内存的是缓存模块，且必须与代理联动：
-
mod_proxy和mod_proxy_http：处理 HTTP 协议代理，把请求发给外部 API -
mod_cache：缓存控制中枢，决定是否缓存、何时过期、如何键值匹配 -
mod_cache_disk（推荐）：将响应体写入磁盘，稳定、容量可控；mod_cache_mem已被标记为实验性，不建议生产使用 -
mod_headers（可选但实用）：用于补全或覆盖后端缺失/错误的缓存头，比如后端没设Cache-Control，可用Header set Cache-Control "public, max-age=300"强制注入
Debian/Ubuntu 系统执行：a2enmod proxy proxy_http cache cache_disk headers；RHEL/CentOS 检查 httpd.conf 是否含对应 LoadModule 行。
缓存路径与代理路径必须对齐
CacheEnable disk /api/ 不代表缓存所有以 /api/ 开头的请求 —— 它匹配的是 Apache 接收到的原始 URL 路径。而当你用 ProxyPass /v1/ http://thirdparty.com/api/ 时，外部 API 的真实路径是 /api/，但 Apache 内部看到的请求路径是 /v1/。所以缓存指令必须写成：
CacheEnable disk /v1/ ProxyPass /v1/ http://thirdparty.com/api/ ProxyPassReverse /v1/ http://thirdparty.com/api/
否则缓存完全不触发。建议先用 CacheEnable disk /static-test/ 配合一个简单静态文件测试命中率，确认缓存目录结构和权限无误后再切到动态路径。
后端响应头是缓存生效的前提
mod_cache 默认拒绝缓存绝大多数 API 响应，因为它严格遵循 HTTP 缓存语义：
- 拒绝含
Set-Cookie的响应（防止用户数据污染共享缓存）→ 需加CacheIgnoreHeaders Set-Cookie - 拒绝
Vary: *或Vary: Authorization（缓存键爆炸）→ 若 API 实际不区分用户身份，可加CacheIgnoreHeaders Vary，但更安全的做法是只忽略无关项，如CacheIgnoreHeaders Accept-Encoding - 拒绝
Cache-Control: no-cache、private、no-store→ 后端必须返回Cache-Control: public, max-age=60（或类似）
验证方式：用 curl -I https://your-apache/v1/users 查看响应头，确认存在有效 Cache-Control 且无阻断性头字段。若后端无法修改，可用 mod_headers 在 Apache 层强制覆盖。
缓存目录与基础参数设置
磁盘缓存需显式声明根目录，并确保 Apache 进程用户（如 www-data）有读写权限：
CacheRoot "/var/cache/apache2/mod_cache_disk" CacheDirLevels 2 CacheDirLength 1 CacheMaxFileSize 1048576 CacheIgnoreNoLastMod On CacheIgnoreCacheControl Off
其中 CacheIgnoreCacheControl Off 是关键开关 —— 若设为 On，即使后端写了 max-age=300，mod_cache 也会无视。日志中不会报错，唯一判断依据是响应头是否出现 X-Cache: HIT 或 X-Cache: MISS。
