apache的rewritecond本身不直接写日志,仅用于条件判断,需结合rewriterule、环境变量(e=)及customlog或rewrite调试日志实现记录功能;分开启trace日志、环境变量标记、重写并记录原始信息三类场景,辅以常见陷阱提示。

Apache 的 RewriteCond 本身不直接写日志,它只是用于条件判断,配合 RewriteRule 实现重写逻辑。但你可以通过组合 RewriteCond + RewriteRule + 环境变量(E=)+ CustomLog 或 LogLevel 配合 rewrite 模块调试日志,来实现“记录重写过程”的效果。
下面分几类实用场景说明怎么写:
注意: Apache 默认不记录重写细节,需手动开启调试或借助环境变量打点。
Apache Superset 是一个广泛采用的开源 BI 平台,用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时,此技能非常有用。
1. 开启 Rewrite 日志(调试用)
仅限开发/排错,生产环境慎用(性能开销大):# httpd.conf 或虚拟主机配置中 LogLevel alert rewrite:trace3 # trace0 ~ trace8,数字越大越详细,trace3 通常够用
重启 Apache 后,重写过程会输出到 error_log(路径看你的 ErrorLog 设置),例如:
[rewrite:trace3] ... Applying pattern '^(.*)$' to uri '/test' [rewrite:trace4] ... RewriteCond: input='example.com' pattern='^www\.' => not-matched
2. 用环境变量标记并记录匹配行为
更轻量、可控制,适合生产环境做审计或监控:# 如果 Host 是 www.example.com,标记为 "www_access"
RewriteCond %{HTTP_HOST} ^www.example.com$ [NC]
RewriteRule ^(.*)$ - [E=REWRITE_TAG:www_access]
# 如果是移动端 User-Agent,标记为 "mobile"
RewriteCond %{HTTP_USER_AGENT} "Android|iPhone|iPad" [NC]
RewriteRule ^(.*)$ - [E=REWRITE_TAG:mobile]
# 记录带标签的访问(需配合 CustomLog)
CustomLog "/var/log/apache2/access_with_tag.log" "%h %l %u %t "%r" %>s %b "%{Referer}i" "%{User-Agent}i" %{REWRITE_TAG}e"
这样每行日志末尾会多一个环境变量值,比如 www_access 或 mobile,方便后续分析。
3. 根据条件重写并记录原始请求信息
比如把特定参数请求重写,并在日志里保留原 QueryString:# 将 ?debug=1 的请求重写到 /debug-handler,同时记下原始 URL
RewriteCond %{QUERY_STRING} (^|&)debug=1(&|$)
RewriteRule ^(.*)$ /debug-handler?path=%{REQUEST_URI}&qs=%{QUERY_STRING} [E=DEBUG_REQ:1,L]
# 日志格式中加入环境变量和原始参数
LogFormat "%h %l %u %t "%r" %>s %b "%{Referer}i" "%{User-Agent}i" %{DEBUG_REQ}e %{qs}e" debuglog
CustomLog "/var/log/apache2/debug.log" debuglog
4. 常见陷阱与建议
- `%{ENV:VAR}` 才能读取环境变量,`%{REWRITE_TAG}` 是变量名,不是内置变量 - `RewriteCond` 的模式匹配默认区分大小写,加 `[NC]` 忽略大小写 - 多个 `RewriteCond` 默认是 AND 关系;要用 OR,加 `[OR]` 标志 - `RewriteRule` 中 `-` 表示不改 URI,只执行标志(如设环境变量) - 环境变量在当前请求生命周期内有效,可用于 `CustomLog`、`SetEnvIf` 或后续规则不复杂但容易忽略细节,关键是理清:条件判断 → 动作执行 → 日志关联。










