Apache HTTP Server 怎么排查 mod_cache 模块加载冲突的报错-Apache-PHP中文网

本质是mod_cache缺失或加载顺序错误；必须先加载mod_cache_module，再加载mod_cache_disk_module等后端模块，且需用apache2ctl -m验证两者均存在，禁用冲突模块如mod_mem_cache。

apache 启动时报 undefined symbol: ap_cache_cacheable_hdrs_out 或类似符号未定义错误，本质是模块依赖关系断裂——mod_cache 缺失或加载顺序错误，而非 mod_cache 本身损坏。

mod_cache 是缓存框架，必须先于所有后端存储模块（如 mod_cache_disk、mod_cache_socache）加载。漏掉它或顺序颠倒，就会触发符号解析失败。

Debian/Ubuntu：运行 a2enmod cache cache_disk（不能只开 cache_disk）；检查 /etc/apache2/mods-enabled/cache.load 和 cache_disk.load 是否都存在且未被注释
RHEL/CentOS：打开 /etc/httpd/conf.modules.d/00-base.conf，确保这两行按此顺序出现且未被注释：
LoadModule cache_module modules/mod_cache.so
LoadModule cache_disk_module modules/mod_cache_disk.so
Windows（XAMPP/phpEnv）：在 httpd.conf 中手动添加，且 mod_cache.so 必须出现在 mod_cache_disk.so 之前

仅启用配置文件不等于模块已载入内存。必须用运行时命令确认：

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

下载

Linux/macOS：apache2ctl -M | grep cache 或 httpd -M | grep cache，输出中应同时包含 cache_module 和 cache_disk_module（或 cache_socache_module）
若只看到一个，说明另一个未加载或路径错误；若都看不到，说明 a2enmod 或 LoadModule 没生效
注意：apachectl configtest 不会报模块未加载错，它只校验语法；真正加载发生在 start 或 restart 阶段

某些看似无关的配置可能间接导致冲突：

禁用或误启了 mod_mem_cache：该模块与 mod_cache_disk 不兼容，共存时可能引发符号覆盖或初始化冲突；生产环境建议只保留一种后端
混用旧版模块路径：例如在 Ubuntu 上手动用 LoadModule 指向 /usr/lib/apache2/modules/mod_cache.so，但实际模块已迁至新路径（如 /usr/lib/apache2/modules/mod_cache.so 通常正确，但需 ls -l 确认文件存在）
Apache 版本不匹配：mod_cache_disk 在 Apache 2.4.5+ 才完整支持 CacheSocache，而 2.2 系列不支持 mod_cache_socache；用 apache2 -v 或 httpd -v 核对版本，再查对应文档

当报 undefined symbol: xxx 时，可直接检查该符号所属模块：

运行 nm -D /usr/lib/apache2/modules/mod_cache.so | grep ap_cache_cacheable_hdrs_out（路径按实际调整），确认符号确实存在于 mod_cache.so 中
若存在，说明是加载顺序问题；若不存在，可能是模块编译不完整（源码安装场景）或版本错配（如用了 2.2 的模块跑在 2.4 上）
源码安装用户需确保编译 mod_cache.c 时一并链接了 cache_util.c、cache_storage.c 等依赖文件，否则符号无法导出