如何将XAMPP配置Apache开启mod_cache模块进行内容缓存？

本文共计1361个文字，预计阅读时间需要6分钟。

在XAMPP中，`mod_cache`默认不启用。若要使用缓存模块，必须单独加载`mod_cache`模块。否则，模块不会产生任何缓存效果——必须配置`mod_cache_disk`（或`mod_cache_socache`）并正确设置路径、权限和响应头规则。否则，所有请求都会显示`X-Cache: MISS`。

怎么确认 mod_cache 和 mod_cache_disk 已真正加载？

别只看 httpd.conf 里有没有 LoadModule 行。XAMPP 的模块启用是分层的，很多模块虽存在但未激活。

• 打开命令行，进入 C:\xampp\apache\bin，执行：httpd -M | findstr cache（Windows）或 ./httpd -M | grep cache（macOS/Linux）
• 必须同时看到 cache_module 和 cache_disk_module —— 缺一不可；如果只看到一个，说明另一个没加载成功
• 常见失败点：mod_cache.so 和 mod_cache_disk.so 文件在 C:\xampp\apache\modules\ 下存在，但 httpd.conf 中对应 LoadModule 行仍被注释，或路径写成 modules/mod_cache.dll（Windows 应为 .dll，不是 .so）
• 启用方式：编辑 C:\xampp\apache\conf\httpd.conf，取消以下两行的注释（注意 Windows 下是 .dll）：
  LoadModule cache_module modules/mod_cache.dll
LoadModule cache_disk_module modules/mod_cache_disk.dll
• 改完后务必运行 httpd -t 验证语法，再重启 Apache（控制面板点 Restart 不会报错细节，容易漏掉问题）

CacheRoot 路径在 XAMPP 下怎么设才安全？

XAMPP 默认没有预建缓存目录，也不能直接用 /tmp 或系统临时路径——Windows 下不存在该路径，且 XAMPP 进程用户（通常是当前登录用户）对随意路径可能无写权限。

• 手动创建目录，例如：C:\xampp\apache\cache_disk
• 在 httpd.conf 或虚拟主机配置中添加：
  CacheRoot "C:/xampp/apache/cache_disk"
  注意：路径用正斜杠或双反斜杠，单反斜杠会引发转义错误
• 确保该目录对运行 Apache 的 Windows 用户有「完全控制」权限（右键 → 属性 → 安全 → 编辑 → 添加当前用户 → 勾选「完全控制」）
• 不要设为网络路径、OneDrive 同步目录或 NTFS 加密文件夹——mod_cache_disk 依赖本地文件原子操作，这些场景会导致缓存写入失败或损坏
• 首次启动后检查该目录是否生成了子目录（如 0/、1/），没生成说明 CacheRoot 未生效或权限拒绝

为什么 CacheEnable disk / 没用？常见匹配失效原因

CacheEnable disk / 看似作用于全部路径，但在 XAMPP 典型开发场景中极易失效，尤其当你用 ProxyPass 转发到本地 Java/PHP 服务时。

• 它只对 Apache 直接响应的请求生效；若你配置了 ProxyPass /api/ http://localhost:8000/api/，那实际缓存路径应为 /api/，而不是后端的 /api/ 或根 /
• 更稳妥的做法是先测试静态资源：
  CacheEnable disk /static/
  然后把图片/CSS/JS 放到 C:\xampp\htdocs\static\ 下访问 http://localhost/static/test.jpg，观察响应头是否有 X-Cache: HIT
• 若仍 MISS，检查后端响应是否含 Set-Cookie 或 Cache-Control: private —— 默认情况下这些会直接跳过缓存，需加：
  CacheIgnoreHeaders Set-Cookie
CacheIgnoreCacheControl off（慎用，仅调试阶段）
• Windows 下注意路径大小写不敏感，但 mod_cache_disk 内部处理仍按字面匹配，避免混用 /Static/ 和 /static/

怎么验证缓存是否真命中？别只看日志

Apache error.log 里只有权限错误或模块加载失败信息，缓存命中/未命中不会默认记录。必须靠响应头和简单请求验证。

• 用 curl -I http://localhost/static/test.jpg 查看响应头，关键字段：
  X-Cache: HIT from localhost 或 X-Cache: MISS
  （X-Cache 是 mod_cache 自动注入的，无需额外配置）
• 首次访问返回 MISS，第二次相同 URL 返回 HIT，且响应时间明显下降（可用浏览器开发者工具 Network 标签页对比），说明磁盘缓存已工作
• 如果始终 MISS，检查是否漏了 CacheRoot、CacheEnable 路径不匹配、或后端响应头带 Vary: Cookie（需加 CacheIgnoreHeaders Vary 才能忽略）
• Windows 下杀毒软件有时会锁定缓存目录，导致写入失败——临时禁用实时防护测试一次

最常被忽略的一点：XAMPP 的 Apache 默认不监听外部请求，CacheEnable 对 localhost 有效，但若你在局域网其他设备上测试，需确认 httpd.conf 中 Require local 是否限制了访问范围，否则请求根本进不到缓存逻辑里。