Apache需通过mod_proxy+mod_cache_disk组合实现后端静态资源本地磁盘缓存，必须启用mod_proxy、mod_proxy_http、mod_cache、mod_cache_disk及mod_headers，CacheEnable路径须与ProxyPass路径一致，Java端须返回public+max-age响应头，CacheRoot目录需Apache进程用户可写。
Apache 本身不提供“分布式缓存”能力，mod_proxy 也不是缓存模块，它只负责反向代理或正向代理的请求转发。所谓“对后端静态资源的自动化分布式缓存”，实际是指：在 Apache 前置部署架构中，通过 mod_proxy + mod_cache_disk 组合，为后端（如 Tomcat、Spring Boot）返回的静态资源（/static/、/assets/ 等路径）建立本地磁盘缓存，并借助外部机制（如 NFS、CDN 或多节点统一代理层）实现近似分布式的缓存效果。
必须启用的核心模块链
缺一不可，否则缓存不会生效：
- mod_proxy 和 mod_proxy_http：用于将请求转发给 Java 后端（例如 ProxyPass /api/ http://localhost:8080/api/）
- mod_cache 和 mod_cache_disk：提供磁盘级响应缓存能力
- mod_headers 或 mod_expires：用于补全或修正后端响应头——Java 应用默认不返回可缓存头，这是缓存命中最常见的失败原因
关键配置逻辑：路径匹配必须对齐代理视图
CacheEnable 的路径不是后端真实路径，而是 Apache 接收到的请求路径（即用户看到的 URL 路径）：
- 若配置 ProxyPass /v1/ http://backend:8080/api/，则应写
CacheEnable disk /v1/，而非/api/ - 若希望缓存所有静态资源，且前端统一走 /static/，就配
CacheEnable disk /static/，并确保后端也把静态文件映射到该路径 - 不要写
CacheEnable disk /试图“全局缓存”——它只对 Apache 直接服务的资源有效，对被 proxy 转发的动态响应无效
Java 后端必须返回合法缓存响应头
Apache mod_cache_disk 极其严格：即使返回了 Cache-Control: max-age=3600，只要没带 public，就拒绝缓存。常见正确写法：
- Spring Boot 示例：
ResponseEntity.ok().header("Cache-Control", "public, max-age=31536000").body(data) - 禁止使用
private、no-store、no-cache（除非明确不希望缓存） - 含用户态数据（如登录态、CSRF Token）的接口，必须返回
Cache-Control: private, no-cache，避免敏感信息被缓存
缓存目录与权限不能出错
典型配置示例：
<IfModule mod_cache_disk.c> CacheRoot "/var/cache/apache2/mod_cache_disk" CacheEnable disk /static/ CacheIgnoreHeaders Set-Cookie CacheIgnoreNoLastMod On CacheDirLevels 2 CacheDirLength 1 </IfModule>
注意：
-
CacheRoot目录必须由 Apache 进程用户（如 www-data 或 apache）可读写，否则日志报(13)Permission denied - 首次建议先测试
/static/下真实存在的图片或 CSS 文件，确认X-Cache: HIT出现后再扩展到动态接口 - 若需多台 Apache 节点共享缓存，不能靠 mod_cache_disk 自身实现——需改用统一 NFS 挂载点（各节点挂同一 CacheRoot），或更推荐用前置 CDN + Apache 仅做轻量代理
