Nginx日志中的URL参数怎么处理

在Nginx的运维中，日志配置是个基本功，但真正用起来，细节上的坑也不少。比如，当业务方想要从日志里分析用户行为时，URL参数往往是关键数据源。可问题来了——那些UTM追踪参数、随机token之类的干扰信息，要不要一起记？答案是：完全取决于你怎么配置。

我们先说标准做法。打开Nginx配置文件——无论是全局的/etc/nginx/nginx.conf，还是站点级别的/etc/nginx/sites-a vailable/your_domain.conf，都可以开始动手。

想要记录URL参数，核心在于利用log_format指令自定义日志格式。在http块里，定义一个你喜欢的格式名，把$query_string变量加进去就行。举个例子：

http {log_format custom '$remote_addr - $remote_user [$time_local] ''"$request" $status $body_bytes_sent ''"$http_referer" "$http_user_agent" "$query_string"';}

这里的$query_string就是请求URL中问号后面的那部分，全量记录。但如果你的目标是忽略某些特定参数——比如大家熟知的utm_source和utm_medium这类营销追踪标记，怎么做？这时就要用到map指令来过滤了。

配置思路是：先用map创建一个新变量，让它只保留你想要的查询字符串，然后把不需要的参数替换为空。下面这段配置就是专门用来剔除utm_source和utm_medium的：

http {map $query_string $clean_query_string {default $query_string;"~*utm_source=([^&]*)" "";"~*utm_medium=([^&]*)" "";}log_format custom '$remote_addr - $remote_user [$time_local] ''"$request" $status $body_bytes_sent ''"$http_referer" "$http_user_agent" "$clean_query_string"';}

注意看，这里map块里用了正则表达式，大小写不敏感（~*），匹配到的参数就会被直接替换为空字符串。然后日志格式里引用的是新变量$clean_query_string，而非原始的$query_string。

接下来，在server或location块中指定使用这个自定义格式：

server {access_log /var/log/nginx/your_domain.access.log custom;}

最后，别忘了检查语法并重启Nginx：

sudo nginx -tsudo nginx -s reload

做完这些，Nginx日志就会按照你想要的规则记录URL参数了——该记的记，不该记的一个不留。当然，实际业务中需要排除的参数种类可能更多，你可以继续在map块中按同样的模式添加即可。关键是要理解这个思路：日志格式可以定制，参数过滤靠map，两者结合就能实现精准的日志记录。