apache需mod_proxy与mod_cache协同才能缓存后端响应,单独mod_cache_disk对spring boot等动态接口无效;必须按序加载mod_cache、mod_cache_disk、mod_proxy、mod_proxy_http及mod_headers模块,cacheenable路径须匹配proxypass原始url,且后端响应头须含public+max-age、不含set-cookie。

Apache 本身不直接缓存后端响应,必须通过 mod_proxy + mod_cache 协同工作才能实现反向代理级缓存。单独启用 mod_cache_disk 对 Spring Boot、Node.js 等动态接口基本无效,关键在于代理链路完整、响应头合规、路径匹配准确。
必须加载并按序启用核心模块
缺一不可,且顺序错误会导致缓存完全不生效:
- mod_cache:缓存框架,必须最先加载
- mod_cache_disk:磁盘存储后端,紧随 mod_cache 后加载
- mod_proxy 和 mod_proxy_http:负责转发请求、接收响应,是缓存的前提
- mod_headers(推荐):用于补全或覆盖后端缺失的 Cache-Control 头,避免因响应头不满足条件而跳过缓存
代理与缓存路径必须严格对应
CacheEnable 的路径匹配的是客户端发起的原始 URL,不是后端真实路径。例如:
Apache 2.4.62 官方 tar.gz 源码包是 Linux 及类 Unix 系统构建 Web 服务器的核心基础。通过源码编译安装,开发者能够灵活定制模块、优化性能并精准控制安装路径,满足多样化的业务需求。
- 若配置
ProxyPass /api/ http://localhost:8080/v1/,则应写CacheEnable disk /api/ - 写
CacheEnable disk /v1/不会命中,因为 Apache 收到的是/api/users,不是/v1/users - 如需缓存全部代理流量,可用
CacheEnable disk /,但要确保静态资源等其他规则不干扰
后端响应头决定能否被缓存
mod_cache_disk 默认只缓存同时满足以下条件的响应:
- 状态码为 200、301 或 404
- 响应头含
Cache-Control: public, max-age=XXX(不能是 private 或 no-cache) - 响应头不含
Set-Cookie(否则默认跳过) - 响应体大小不超过
CacheMaxFileSize(默认 1MB,可调)
若后端(如 Spring Boot)未返回合适头,可在 Apache 配置中强制补充:Header always set Cache-Control "public, max-age=300"
或移除干扰头:Header unset Set-Cookie
缓存目录与权限要正确设置
磁盘缓存依赖文件系统写入,常见配置项包括:
-
CacheRoot /var/cache/apache2:必须是 Apache 进程有读写权限的目录 -
CacheDirLevels 2和CacheDirLength 1:控制子目录结构,防止单目录文件过多 -
CacheMaxExpire 86400:最大允许缓存时长(秒),高于后端 max-age 也以此为准 -
CacheIgnoreHeaders Set-Cookie:显式忽略 Set-Cookie 头以允许缓存(需确认业务无用户态依赖)










