关键不是“加个模块就自动缓存”，而是明确路径（如CacheEnable disk /api/）、存储方式（mod_cache_disk）、缓存依据（Cache-Control: public, max-age=300）及用户区分（Vary头），需模块顺序正确、响应头合规、路径匹配一致三者全部到位。在虚拟主机中配置 `mod_cache`，关键不是“加个模块就自动缓存”，而是让 Apache 明确知道：**对哪些路径缓存、用什么方式存、依据什么判断是否可缓存、怎么区分不同用户的响应**。整个过程必须围绕请求路径、响应头、缓存键逻辑三者协同展开。
一、确认模块已启用且顺序正确
apache 2.4 要求模块按依赖顺序加载：mod_cache 必须在 mod_cache_disk（或 mod_cache_socache）之前；若代理后端，还需 mod_proxy 和 mod_headers。
在主配置或 a2enmod 后验证：
apache2ctl -M | grep -E 'cache|proxy|headers'
应同时看到：cache_module、cache_disk_module、proxy_module、headers_module。
二、在 <VirtualHost> 内配置磁盘缓存基础参数
缓存根目录必须由 Apache 进程用户（如 www-data）完全可写，且不能位于 NFS 或临时挂载点。
示例配置（放在 <VirtualHost *:80> 或 <VirtualHost *:443> 块内）：
<IfModule mod_cache.c>
<IfModule mod_cache_disk.c>
CacheRoot /var/cache/apache2/vhost-cache
CacheEnable disk /api/
CacheDirLevels 2
CacheDirLength 1
CacheIgnoreHeaders Set-Cookie
CacheIgnoreNoLastMod On
CacheDefaultExpire 60
</IfModule>
</IfModule>
说明：
Apache Superset Dashboard and SQL Exploration Skill
下载
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
-
CacheEnable disk /api/表示只对以/api/开头的原始请求路径启用缓存（不是后端真实路径） -
CacheIgnoreHeaders Set-Cookie是常见必要项——否则含 Cookie 的响应默认被跳过 -
CacheIgnoreNoLastMod On允许缓存没有Last-Modified或ETag的响应（如多数 JSON API）
三、配合后端响应头控制缓存行为
Apache 不会强行缓存不合规的响应。后端（如 Spring Boot、PHP-FPM）必须返回明确的缓存指令：
- 必须含
Cache-Control: public, max-age=300（public关键，仅max-age不生效） - 不能含
Set-Cookie（除非你已用CacheIgnoreHeaders显式忽略） - 避免
Vary: *或Cache-Control: private, no-store - 状态码建议为 200、301、404（若需缓存 404，需额外配
CacheIgnoreNoLastMod On并确保响应头合规）
若后端无法修改，可用 mod_headers 强制注入（慎用）：
<Location "/api/"> Header always set Cache-Control "public, max-age=300" Header unset Set-Cookie </Location>
四、差异化缓存需显式构造缓存键
Apache 默认按完整 URL（含查询参数）生成缓存键。如需按设备、地区等维度隔离，不能靠“自动识别”，而要主动干预：
- 用
Vary头声明维度：Header append Vary User-Agent→ 同一 URL 下，手机和桌面端各自独立缓存 - 用
mod_rewrite标准化查询参数：RewriteCond %{QUERY_STRING} ^(.*)(?:&|^)(utm_[^&]+|v|ts)=[^&]*(.*)$+RewriteRule ^(.*)$ $1?%1%2 [R=301,L]，剔除干扰参数再缓存 - 对登录态内容，不建议缓存；如必须，改用
Vary: Cookie（但会大幅降低命中率）或提取 session ID 后哈希作为缓存键一部分（需自定义逻辑）
配置完成后重启 Apache，并用 curl -I https://yoursite.com/api/data 检查响应头是否含 X-Cache: HIT（需提前用 Header set X-Cache "HIT" env=cache_hit 启用标记）。缓存是否生效，最终取决于路径匹配、响应头合规性、模块协同这三点是否全部到位。
