如何在Apache中利用mod_cache优化API动态响应的高频重复请求教程-Apache-PHP中文网

apache mod_cache可缓存api响应，但需后端显式设置cache-control: public, max-age、禁用set-cookie与vary: *，并配置cacheignorecachecontrol off等关键项，否则静默跳过。

如何在apache中利用mod_cache优化api动态响应的高频重复请求教程

Apache 的 mod_cache 能缓存 API 动态响应，但不是“开箱即用”，必须后端明确授权、配置精准匹配、规避默认拦截规则，否则静默跳过——这是绝大多数人配置失败的根本原因。

API 响应必须显式声明可缓存

mod_cache 默认拒绝缓存绝大多数 API 响应，因为它会检查三个硬性条件：

Cache-Control 头必须含 public 且带 max-age（或 s-maxage）：例如 Cache-Control: public, max-age=60；仅写 max-age=60 或 no-cache 都不生效
不能含 Set-Cookie、Vary: *：Set-Cookie 表示响应含用户私有状态，默认禁用缓存；Vary: * 让缓存键失去意义，直接放弃缓存
状态码需在默认可缓存列表中：200、301、302 等可以，404、500、401 默认不缓存（除非额外配置 CacheStorePrivate On，但不推荐用于 API）

实操建议：用 curl -I https://your-api.com/v1/data 查看真实响应头。若返回 Cache-Control: no-cache 或缺失该头，说明后端未配合，Apache 不会缓存。

后端代码必须主动设置缓存策略

不要依赖 Apache 自动加头，缓存控制权必须由 API 逻辑决定。不同框架示例：

Apache Superset Dashboard and SQL Exploration Skill

Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。

下载

Express（Node.js）：res.set('Cache-Control', 'public, max-age=300')
Spring Boot：在 Controller 方法上加 @ResponseCache(maxAge = 300)，或手动 response.setHeader("Cache-Control", "public, max-age=300")
Java Servlet：response.setHeader("Cache-Control", "public, s-maxage=300")（s-maxage 优先级高于 max-age，专用于共享缓存）

避免陷阱：不要返回 Cache-Control: private；不要为每个请求动态生成 ETag 或 Last-Modified（除非内容真实变化），否则缓存命中率归零。

Apache 配置要精简、安全、可落地

推荐使用 mod_cache_disk（稳定、可控），禁用 mod_cache_mem（实验性、多数发行版已弃用）。关键配置项：

启用模块：Debian/Ubuntu 运行 a2enmod cache cache_disk headers；CentOS/RHEL 确保 LoadModule cache_module 和 cache_disk_module 已加载

基础路径与结构：

<ifmodule mod_cache.c><ifmodule mod_cache_disk.c>
    CacheRoot "/var/cache/apache2/mod_cache_disk"
    CacheDirLevels 2
    CacheDirLength 1
    CacheMaxFileSize 1048576
  </ifmodule></ifmodule>

启用缓存并过滤干扰：在 <location></location> 或对应路径块中配置：
```
CacheEnable disk
CacheIgnoreHeaders Set-Cookie
CacheIgnoreHeaders Vary
CacheIgnoreCacheControl Off
```
注意：只在确认 API 不设 Cookie、且 Vary 头无实际区分意义时才忽略 Vary；CacheIgnoreCacheControl Off 是必须项，否则后端的 max-age 会被无视

验证是否真正生效

mod_cache 不报错、不提示，全靠响应头和日志判断：

看响应头：成功命中缓存时，Apache 会自动添加 X-Cache: HIT from example.com；未命中则为 X-Cache: MISS
查错误日志：开启 CacheLock on 后，若并发请求触发锁等待，会在 error_log 中记录 cache lock acquired 类信息
观察磁盘缓存目录：执行请求后，检查 /var/cache/apache2/mod_cache_disk/ 下是否有新生成的文件（注意权限：目录需属 www-data 或 apache 用户且可写）