Apache mod_log_config 无法直接记录URL查询参数，但可通过SetEnvIfNoCase正则提取（如id=([^&]+)）并设为环境变量，再在LogFormat中用%{req_id}e引用实现；需注意URL编码需后处理、正则边界严谨性及配置重载验证。
Apache 的 mod_log_config 本身不直接支持提取并记录 URL 查询字符串（QueryString）中的某个特定参数（如 ?id=123&type=video 中的 id），但可以通过组合使用 %{QUERY_STRING}e、SetEnvIfNoCase 和正则捕获，再配合自定义日志格式实现。核心思路是：先用环境变量提取参数值，再在 LogFormat 中引用该变量。
步骤一：用 SetEnvIfNoCase + 正则捕获目标参数值
在 Apache 配置（如 httpd.conf 或虚拟主机配置）中添加类似以下指令，以提取 id 参数为例：
# 提取 ?id= 后面的值（支持数字、字母、下划线、短横线） SetEnvIfNoCase Query_String "id=([^&]+)" req_id=$1 <h1>若需提取多个参数（如 id 和 type），可分别定义</h1><p>SetEnvIfNoCase Query_String "type=([^&]+)" req_type=$1</p>
说明：
• Query_String 是 Apache 内置的环境变量名，对应原始查询字符串（不含 ?）；
• 正则 id=([^&]+) 匹配 id= 后直到 & 或结尾的非空内容；
• $1 表示捕获组内容，将赋值给环境变量 req_id；
• 使用 SetEnvIfNoCase 而非 SetEnvIf 可避免大小写敏感问题（如 ID= 或 iD=）。
步骤二：定义含环境变量的日志格式
在 LogFormat 中使用 %{req_id}e 引用上一步设置的环境变量：
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\" \"%{req_id}e\" \"%{req_type}e\"" custom_query
CustomLog /var/log/apache2/access_query.log custom_query
说明：
• %{req_id}e 表示读取名为 req_id 的环境变量值；
• 若请求不含 id=，该字段将为空（显示为短横线 -）；
• 日志行末尾会追加两个字段：提取的 id 值和 type 值。
注意事项与常见问题
-
URL 编码需手动处理：正则匹配的是原始编码字符串（如
q=hello%20world），若需解码，Apache 本身不支持自动解码，建议后处理（如用 Python/awk 解码日志）或改用mod_rewrite+RewriteLog（不推荐用于生产日志） -
参数名边界要严谨：正则
id=([^&]+)可能误匹配myid=，更安全写法是(?:^|&)id=([^&]+)，但SetEnvIfNoCase不支持多选分支，实际常用开头锚点^id=或确保参数名唯一 -
环境变量作用域：
SetEnvIfNoCase设置的变量仅对当前请求有效，不影响其他请求，无需清理 - 性能影响极小：正则仅在请求进入日志前执行一次，对吞吐量无明显影响
验证是否生效
重启 Apache 后，发起测试请求：
curl "http://localhost/test.php?id=abc123&type=image"
检查日志文件，应看到类似：
127.0.0.1 - - [10/Jan/2025:14:22:33 +0800] "GET /test.php?id=abc123&type=image HTTP/1.1" 200 123 "-" "-" "abc123" "image"
若字段为空，检查正则是否匹配、参数是否拼写正确、Apache 是否已重载配置（sudo systemctl reload apache2 或 apachectl graceful）。
