Apache mod_log_config不支持直接提取QueryString参数，需用expr=结合%{QUERY_STRING}e正则匹配（如/token=(1*)/），值仍为URL编码；生产环境推荐mod_rewrite预处理解码后存入环境变量再记录。& ↩
Apache 的 mod_log_config 模块本身不支持直接解析和提取 URL 中的特定 QueryString 参数（如 ?id=123&token=abc 中的 token）。它只能记录完整请求行 %r、原始查询字符串 %q，或整个 URI %U，但无法做键值匹配或解码后提取单个参数。
要实现“记录特定查询参数”，需结合 Apache 2.4+ 的 表达式日志（expr=）功能，配合正则匹配与 URL 解码处理。以下是实用、可靠的操作方式：
✅ 正确做法：用 expr= + 正则从 %{QUERY_STRING}e 中提取
Apache 提供环境变量 QUERY_STRING（可通过 %{QUERY_STRING}e 引用），其值为 URL 中 ? 后的原始未解码字符串（如 id=123&name=john%20doe）。
利用 expr= 语法可对其做正则匹配，并捕获目标参数值：
LogFormat "%h %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\" %{expr=%{env('QUERY_STRING') =~ /(?:^|&)token=([^&]*)/ ? $1 : '-'}s" token_log
CustomLog /var/log/apache2/access_token.log token_log
说明：
-
%{env('QUERY_STRING')}获取原始查询字符串（注意是env，不是reqhdr） - 正则
/^(?:&|)token=([^&]*)/匹配token=开头、以&或结尾终止的值（支持参数在开头或中间） -
$1是捕获组，即token=后面的内容（未解码） - 若未匹配，返回
'-'，避免空字段
⚠️ 注意：该值仍是 URL 编码状态（如
john%20doe），Apache 默认不自动解码。如需解码，需额外用mod_rewrite预处理并设环境变量，或交由下游系统（如 ELK、Java 日志处理器）解码。
✅ 进阶：安全提取并解码（推荐用于生产）
若必须在日志中记录已解码的参数值，可借助 mod_rewrite + SetEnvIf 预处理（仅限简单参数）：
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
# 在 VirtualHost 或目录配置中启用
RewriteEngine On
# 匹配 token=xxx 并解码后存入环境变量 TOKEN_DECODED
RewriteCond %{QUERY_STRING} (?:^|&)token=([^&]+)
RewriteRule ^ - [E=TOKEN_DECODED:%1]
# 使用 SetEnvIfNoCase 确保环境变量可用（兼容部分旧版）
SetEnvIf Request_URI ".*" TOKEN_DECODED=%{ENV:TOKEN_DECODED}
LogFormat "%h %t \"%r\" %>s %b \"%{TOKEN_DECODED}e\"" decoded_token_log
CustomLog /var/log/apache2/access_decoded.log decoded_token_log
✅ 优点：值已解码（如
john doe）
❌ 局限：SetEnvIf不支持运行时解码逻辑，此法依赖 Rewrite 规则提取；复杂嵌套或多重编码场景仍建议下游解码。
❌ 常见误区（请避开）
-
"%{token}q"或"%{QUERY_STRING:token}e"—— 不存在这种语法，Apache 不支持结构化查询参数访问 - 直接用
%{THE_REQUEST}i再用外部工具解析 —— 不可靠，HTTP/2 下THE_REQUEST会被伪造为 HTTP/1.1，且含多余空格和协议字段 - 试图用
%{REQUEST_URI}p提取 ——REQUEST_URI不含查询字符串，%{REQUEST_URI}p也无此用法
? 验证是否生效
-
发起测试请求：
curl "http://localhost/test?user=admin&token=xyz123&debug=true"
-
查看日志输出是否类似：
127.0.0.1 [28/Apr/2026:08:03:15 +0000] "GET /test?user=admin&token=xyz123&debug=true HTTP/1.1" 200 123 "-" "-" xyz123
-
若始终为
-，检查：- Apache 版本 ≥ 2.4.13（
expr=支持要求） -
mod_setenvif和mod_rewrite是否启用（a2enmod setenvif rewrite） -
QUERY_STRING环境变量是否被其他规则覆盖
- Apache 版本 ≥ 2.4.13（
不复杂但容易忽略细节。
