Apache HTTP Server 怎么通过日志排查 mod_rewrite 运行异常-Apache-PHP中文网

apache mod_rewrite不执行的主因是未启用模块、未开启trace日志或allowoverride限制导致规则未被读取；需依次检查loadmodule、loglevel rewrite:trace3及directory中allowoverride all配置。

apache 的 mod_rewrite 不执行、规则“像没写一样”，绝大多数时候不是规则写错了，而是它根本没被调用——日志就是最直接的证据来源。关键不在于“有没有报错”，而在于“有没有记录重写动作”。下面分三步讲清楚怎么用日志定位真实问题。

如果 error_log 里连一句跟 rewrite 相关的提示都没有，甚至搜索 RewriteEngine 或 RewriteRule 都无结果，那第一步一定是检查模块是否真正启用：

在主配置文件（如 /etc/apache2/apache2.conf 或 /etc/httpd/conf/httpd.conf）中查找 LoadModule rewrite_module，确保该行未被注释（即前面没有 #）
Debian/Ubuntu 系统可运行 a2enmod rewrite && systemctl restart apache2；CentOS/RHEL 则需手动确认模块路径（如 /usr/lib64/httpd/modules/mod_rewrite.so）并补全 LoadModule 行
重启后执行 apache2ctl -M | grep rewrite（或 httpd -M | grep rewrite），输出应为 rewrite_module (shared)

mod_rewrite 在 Apache 2.4+ 中不再支持 RewriteLog 指令，必须用 LogLevel 控制其详细输出。默认情况下它完全静默，所以你需要主动“打开它的嘴”：

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

下载

在主配置的全局段（非 <virtualhost></virtualhost> 或 <directory></directory> 内）添加一行：
LogLevel alert rewrite:trace3
不要设成 trace8，调试用 trace3～trace4 足够；生产环境建议关掉（即删掉该行或设为 rewrite:warn）
重启 Apache 后访问一个会触发重写的 URL，然后立即查看错误日志：
Debian/Ubuntu： tail -f /var/log/apache2/error.log
CentOS/RHEL： tail -f /var/log/httpd/error_log
若日志中出现类似 [rewrite:trace3] ... applying pattern '^(.*)\.html$' to uri '/test.html'，说明规则已进入处理流程；若完全没这类记录，问题出在上下文授权（见下一步）

日志空、trace 不出、规则在 .htaccess 里写了也不生效？这是 Debian 10+/Ubuntu 20.04+ 和 CentOS 7+ 最常见的“假失效”。根本原因不是模块问题，而是 Apache 根本没读你的 .htaccess：

检查对应站点目录的 <directory></directory> 块，确认其中包含：
AllowOverride All 或至少 AllowOverride FileInfo（RewriteEngine 和 RewriteRule 属于 FileInfo 类指令）
Debian 系默认是 AllowOverride None，这是安全策略，不是 bug；CentOS 7 的 httpd 包也常默认禁用
若使用虚拟主机，确保 <virtualhost></virtualhost> 内嵌套的 <directory></directory> 块设置了正确的 AllowOverride，而不是只在全局 <directory>></directory> 里配了
顺手检查 Require 指令是否阻断了访问（例如 Require local 会让外网请求连进都进不来，自然不会走到 rewrite 阶段）