必须按mod_socache_shmcb→mod_authn_socache→mod_auth_basic顺序加载，CacheProvider与AuthnCacheSOCache别名须严格一致（如shmcb），并配置CacheQuickHandler off、确保缓存路径可写且AuthnCacheTimeout合理（默认300秒）。
能提，但必须配对加载、顺序写对、缓存路径可写，否则压根不生效。
模块加载顺序错，缓存直接被跳过
mod_authn_socache 不是独立认证模块，它只提供缓存层，必须和 mod_auth_basic 或 mod_auth_digest 配合使用。而底层依赖 mod_socache_shmcb 提供共享内存能力——三者缺一不可，且加载顺序不能乱：
-
mod_socache_shmcb必须最先加载（缓存基础设施） -
mod_authn_socache次之（缓存逻辑桥接） -
mod_auth_basic（或mod_auth_digest）最后（实际认证入口）
在 httpd.conf 或 Debian/Ubuntu 的 a2enmod 后，用 httpd -M | grep -E "(socache|authn|basic)" 确认顺序。如果看到 authn_socache 在 socache_shmcb 前面，Apache 启动会失败或静默降级为无缓存模式。
CacheProvider 和 AuthnCacheSOCache 名字不一致
这两个指令的“缓存别名”必须完全匹配，否则认证模块找不到缓存实例：
-
CacheProvider shmcb:/var/cache/apache2/socache-shmcb(512000)—— 这里别名是shmcb（括号前第一个词） -
AuthnCacheSOCache shmcb—— 必须写成一模一样的shmcb，不能是shmcb_cache或留空
常见错误：复制示例时把路径当别名，比如写成 AuthnCacheSOCache /var/cache/apache2/socache-shmcb，这会导致缓存永不命中。另外，/var/cache/apache2/ 目录需确保 Apache 进程（如 www-data 或 apache）有读写权限，否则 shmcb 初始化失败，日志里会出现 cache initialization failed。
AuthnCacheTimeout 设得太短或太长都伤性能
这个值控制缓存条目的有效期（单位秒），默认 300（5 分钟），但实际要按业务节奏调：
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
- 健康检查探针类高频请求（每秒多次）：设成 60～120，避免缓存雪崩式刷新
- 普通用户登录后长时间浏览静态资源：可设到 600～1800，减少重复校验
- 绝不设为 0 或负数——Apache 会拒绝启动；也不建议超过 3600，过期时间越长，缓存污染风险越高（比如用户密码改了但缓存没清）
注意：AuthnCacheTimeout 是从缓存写入时间起算，不是每次访问重置。所以它本质是“最大容忍陈旧时间”，不是“活跃会话时长”。
没关 CacheQuickHandler，缓存根本不会触发
Apache 默认启用 quick handler 机制，对很多简单请求（比如 OPTIONS、HEAD、部分 GET）会绕过主请求处理链——而 mod_authn_socache 的缓存检查发生在主链中。结果就是：你配置全对，但 90% 的请求根本不走缓存逻辑。
必须显式关闭：
CacheQuickHandler off
该指令需放在全局上下文（如 httpd.conf 最外层），不能只放在 <directory></directory> 或虚拟主机里。漏掉这一句，mod_authn_socache 就像没装一样。
最易忽略的是缓存路径权限和 CacheQuickHandler off ——前者导致模块初始化失败却无明确报错，后者让整个缓存逻辑形同虚设。调的时候先看 error_log 里有没有 socache-shmcb: failed to initialize 或 authn_socache: cache not available，再确认 quick handler 是否关掉。
