XAMPP开启Apache缓存模块mod_cache配置方法

本文深入解析了在XAMPP环境中正确配置Apache磁盘缓存的完整流程与关键避坑指南：从必须同时启用mod_cache和mod_cache_disk模块并验证加载状态，到安全创建并授权CacheRoot目录、精准设置CacheEnable路径以匹配实际请求（尤其注意代理转发场景），再到通过响应头X-Cache字段直观验证命中效果，同时揭示了权限限制、响应头拦截（如Set-Cookie、Vary）、杀毒软件干扰及本地访问策略等极易被忽视却导致缓存“静默失效”的真实原因——每一步都直击开发者在本地开发中配置缓存时反复踩坑的痛点，助你真正让XAMPP的Apache缓存跑起来、稳下来、看得见。

mod_cache 在 XAMPP 中默认不启用，且单独加载 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 是否限制了访问范围，否则请求根本进不到缓存逻辑里。

今天关于《XAMPP开启Apache缓存模块mod_cache配置方法》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！