nginx日志中“-”是空值占位符，并非bug；常见于$remote_user、$http_referer、$http_x_forwarded_for等易缺失变量；可通过条件记录、map默认值替换或精简日志格式减少其出现。
Nginx 日志中频繁出现的中划线（-），本质上是空值占位符，表示对应变量在当前请求中未获取到有效值。这不是 bug，而是 Nginx 的默认行为——它不会留空字段，而是统一用 - 填充缺失内容。要减少这类符号，关键在于理解哪些变量容易为空、何时为空，以及如何通过配置规避或替代。
哪些变量最常输出中划线
以下变量在多数真实请求中存在天然缺失可能，是日志中 - 的主要来源：
-
$remote_user：仅当启用 HTTP Basic Auth 且用户成功认证时才有值，否则恒为
- - $http_referer：直接输入 URL 访问、HTTPS→HTTP 跳转、浏览器隐私模式、部分 App 内嵌 WebView 等场景下该头可能完全不发送，Nginx 无法取值
- $http_x_forwarded_for：仅当上游有代理（如 CDN、LB）主动添加该头时才存在；若直连或代理未设置，该变量为空
-
$request_time 和 $upstream_response_time：虽然极少为空，但在极早期连接中断（如 TCP 握手失败）时可能无值，部分旧版本 Nginx 会记为
-
用条件判断跳过空值记录
Nginx 支持 if 条件写入日志，可避免将含大量 - 的请求写入主日志文件。例如，只记录带有效 Referer 的请求：
log_format referer_ok '$remote_addr [$time_local] "$request" $status $body_bytes_sent "$http_referer"';
access_log /var/log/nginx/access_with_ref.log referer_ok if=$valid_referer;
<p>map $http_referer $valid_referer {
"" 0;
default 1;
}</p>
这样配置后，无 Referer 的请求不会写入 access_with_ref.log，从源头减少中划线条目。注意：if 仅支持在 access_log 指令中使用，不可用于 log_format 内部。
用 map 指令提供默认值替代中划线
对必须保留的字段（如 $http_x_forwarded_for），可用 map 提供兜底值，把 - 替换为更明确的字符串，比如 direct 或客户端真实 IP：
map $http_x_forwarded_for $real_ip {
"" $remote_addr;
default $http_x_forwarded_for;
}
<p>log_format main '$real_ip - $remote_user [$time_local] "$request" $status $body_bytes_sent "$http_referer" "$http_user_agent"';</p>
这样，当 $http_x_forwarded_for 为空时，$real_ip 自动取 $remote_addr，日志中就不再出现 -，而是真实 IP，既消除了占位符，又提升了日志可读性与分析价值。
精简日志格式，剔除高失效率字段
如果业务不需要某些易空字段，最直接的方式是不在 log_format 中引用它们。例如：
- 若不依赖认证系统，可去掉
$remote_user - 若不做来源渠道归因，可省略
$http_referer - 若无多层代理架构，
$http_x_forwarded_for可不采集
一个轻量但信息完整的生产常用格式示例：
log_format concise '$remote_addr [$time_local] "$request" $status $body_bytes_sent "$http_user_agent" $request_time';
该格式去掉了全部高失效率字段，保留了 IP、时间、请求行、状态码、响应体大小、UA 和处理耗时——这些字段在绝大多数请求中都有稳定取值，日志干净度显著提升。
