如何配置 Apache 动态内容的缓存分层策略-Apache-PHP中文网

apache可通过mod_cache、mod_headers、mod_env与表达式组合实现动态内容缓存分层：第一层依响应头（如cache-control）决定是否缓存；第二层按路径/类型设策略（静态强缓存、动态短时效、api限200响应）；第三层用环境变量区分用户角色并注入vary头；第四层交由后端处理复杂业务逻辑，apache仅执行缓存调度。

如何配置 apache 动态内容的缓存分层策略

Apache 本身不直接支持“动态内容缓存分层”这种抽象概念，但可以通过组合模块与逻辑判断，实现按响应性质、用户身份、路径特征、HTTP头状态等维度区分缓存行为的分层效果。关键不是靠单一指令，而是用 mod_cache + mod_headers + mod_env + <if></if> 表达式 + 后端协作，构建多级决策链。

明确分层目标：什么该缓存？谁该看到什么版本？

动态内容缓存分层，本质是解决三个问题：

是否缓存？（比如带 Set-Cookie 或 Cache-Control: private 的响应默认不缓存）
缓存多久？（管理员看到的数据可能 1 分钟刷新，普通用户可缓存 10 分钟）
缓存哪一份？（同一 URL，不同用户组/设备/语言应有独立副本）

Apache 的 mod_cache 默认只认 URL + Host + Vary 头，不自动识别用户身份或业务角色。所以分层必须显式注入标识。

第一层：基于响应头的粗粒度分层（最基础）

启用 mod_cache 和 mod_cache_disk 后，先设定通用规则：

<ifmodule mod_cache.c><ifmodule mod_cache_disk.c>
    CacheRoot "/var/cache/apache2/mod_cache_disk"
    CacheEnable disk /
    CacheDirLevels 2
    CacheDirLength 1
    CacheMaxExpire 86400
    CacheIgnoreNoLastMod On
    CacheIgnoreHeaders Set-Cookie Cache-Control
    CacheStorePrivate Off
    CacheStorePublic On
  </ifmodule></ifmodule>

⚠️ 注意：CacheIgnoreHeaders Set-Cookie 是双刃剑——它让含会话 Cookie 的响应也能进缓存，必须配合后端清除敏感字段或返回 Vary: Cookie，否则会导致用户 A 看到用户 B 的页面。

建议改为更安全的做法：

CacheIgnoreHeaders Cache-Control
CacheIgnoreNoLastMod Off

让 Apache 尊重后端返回的 Cache-Control: public, max-age=60 或 private，由应用控制缓存意愿。

第二层：按路径和内容类型分策略（静态 vs 动态 vs API）

用 <location></location> 或 <filesmatch></filesmatch> 隔离不同资源：

# 静态资源：强缓存，忽略查询参数
<location>
  CacheEnable disk /
  CacheIgnoreQueryString On
  Header always set Cache-Control "public, max-age=31536000, immutable"
</location>

# 动态 HTML 页面：短时效 + Vary 支持
<location>
  CacheEnable disk /
  CacheIgnoreHeaders Set-Cookie
  # 让缓存区分登录态（需后端设 Vary: Cookie）
  Header always set Vary "Cookie,Accept-Encoding"
  CacheDefaultExpire 300
</location>

# JSON API：仅缓存成功响应，且需认证上下文
<location>
  CacheEnable disk /
  # 只缓存 200 响应（排除 4xx/5xx）
  CacheQuickHandler off
  CacheLock on
  CacheLockPath "/tmp/mod_cache_lock"
</location>

✅ 关键点：

Apache Superset Dashboard and SQL Exploration Skill

Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。

下载

CacheQuickHandler off 确保 Apache 不跳过缓存检查直接交由后端；
Vary 头决定缓存 Key 是否包含对应请求头值（如 Vary: Cookie → 每个 Cookie 值生成独立缓存项）；
CacheLock 防止并发请求重复回源。

第三层：按用户组/角色做差异化缓存（需环境变量介入）

mod_cache_socache 本身不识别用户，但你可以用认证后设置的环境变量驱动响应头：

假设已通过 mod_auth_basic 或 mod_authnz_ldap 完成登录，并用 SetEnvIf 标记角色：

# 认证成功后设置 USER_ROLE
SetEnvIf Authorization "(?i)^Basic\s+([A-Za-z0-9+/]*={0,2})$" AUTH_USER_ENCODED=$1
# （实际中建议用 mod_authnz_ldap 的 LDAP-Group 属性判断，此处简化示意）
SetEnvIf Remote_User "^admin@.*$" USER_ROLE=admin
SetEnvIf Remote_User "^user@.*$" USER_ROLE=user

再用 <if></if> 注入不同缓存策略：

<if>
  Header always set Cache-Control "public, max-age=60"
</if><if>
  Header always set Cache-Control "public, max-age=1800"
</if><if>
  Header always set Cache-Control "no-store"
</if>

? 这样，同一 /dashboard 页面，admin 用户缓存 1 分钟，普通用户缓存 30 分钟，未登录者不缓存。

⚠️ 注意：Vary 必须包含能区分用户组的头（如 X-User-Role），否则 Apache 会把所有响应混为一个缓存项。后端需输出 Vary: X-User-Role，且前端请求带上该头（或由 Apache 用 RequestHeader set X-User-Role %{USER_ROLE}e 注入）。

更稳的第四层：把复杂逻辑交给后端

当分层涉及字段级差异（例如“VIP 用户响应含实时库存，普通用户不含”），Apache 层做太重：

后端根据 Authorization 或 Cookie 解析角色；
输出 Cache-Control: public, max-age=60 + Vary: X-User-Tier；

Apache 只需信任并执行：

Header always set Vary "X-User-Tier,Accept-Encoding"
CacheIgnoreHeaders Cache-Control

这样既清晰又可靠，Apache 专注缓存调度，业务逻辑在应用层统一维护。

缓存分层不是堆砌指令，而是层层收敛：从路径粗筛 → 到响应头契约 → 再到身份标签 → 最终交由后端兜底。配置不难，关键是每层之间逻辑对齐、Vary 头写对、环境变量传得准。