求助：Nginx log_format修改后不生效，日志仍使用默认格式

排查步骤 #

• 确认配置重载操作
  修改配置后必须执行重载命令让配置生效：

  nginx -s reload
  # 或针对systemd管理的系统
  systemctl reload nginx
  

  先执行nginx -t检查配置语法，输出test is successful才能确保配置无语法错误。

• 核对日志文件路径
  确认你查看的日志文件和server块中指定的路径一致：你配置的是/var/log/nginx/site-access.log，不要误看默认的/var/log/nginx/access.log。可以用实时监控命令验证：

  tail -f /var/log/nginx/site-access.log
  

• 调整log_format定义位置
  将log_format定义放在http块的最顶部，避免被后续嵌套配置（如include的子配置）意外覆盖，即使nginx -T | grep log_format只显示你设置的格式，位置错误也可能导致不生效。

• 检查access_log配置冲突
  用以下命令查看所有access_log配置，确认是否有location块单独设置了access_log且未指定格式（会继承默认格式，覆盖server块配置）：

  nginx -T | grep -A2 -B2 access_log
  

• 验证变量正确性
  确认日志格式中的变量是否符合需求：比如$bytes_sent是发送给客户端的总字节数，$body_bytes_sent是响应体的字节数，变量错误可能导致格式看起来无变化。

示例正确配置 #

http {
    # 放在http块最顶部
    log_format main '$remote_addr - $remote_user xxx[$time_local]xxx '
                    '"$request" $status $body_bytes_sent '
                    '"$http_referer" "$http_user_agent"';

    access_log /var/log/nginx/access.log main;

    server {
        listen 80;
        server_name example.com;

        access_log /var/log/nginx/site-access.log main;

        # 其他站点配置...
    }
}

内容的提问来源于stack exchange，提问作者Eric Brown