Nginx使用$bytes_received变量报未知变量错误，版本为1.13.9

嘿，我来帮你捋捋这个头疼的问题！你明明用的是Nginx 1.13.9（确实在bytes_received变量引入的版本1.11.4之后），但启动时却提示这个变量未知，这确实有点反常。我给你几个排查方向和解决方案：

1. 检查log_format的定义位置 #

log_format是全局配置项，必须放在http块内部，不能放在server或location块里。如果位置不对，Nginx可能无法正确识别核心变量，导致误报错误。

正确的配置示例：

http {
    # 在这里定义日志格式
    log_format postdata '$remote_addr sent $bytes_received bytes';

    server {
        # 在server块里引用这个日志格式
        access_log /usr/local/nginx/logs/postdata.log postdata;
        
        # 其他server配置...
        listen 80;
        server_name your-domain.com;
    }
}

2. 排查配置文件的语法错误 #

有时候看似是变量的问题，其实是配置里的语法错误导致的，比如：

• 引号没有闭合（比如结尾少了'）
• 分号遗漏
• 特殊字符没有转义

你可以先用nginx -t命令测试配置的语法正确性，它会告诉你具体的错误行号和原因：

/usr/local/nginx/sbin/nginx -t

3. 用最小化配置测试 #

如果你的主配置文件里有很多复杂的规则，可能是其他配置干扰了变量识别。你可以写一个极简的测试配置，只保留必要的部分，看看能不能正常启动：

user root;
worker_processes 1;

error_log /usr/local/nginx/logs/error.log;
pid /usr/local/nginx/logs/nginx.pid;

events {
    worker_connections 1024;
}

http {
    include mime.types;
    default_type application/octet-stream;

    log_format postdata '$remote_addr sent $bytes_received bytes';

    server {
        listen 80;
        server_name localhost;
        access_log /usr/local/nginx/logs/test_access.log postdata;

        location / {
            root html;
            index index.html;
        }
    }
}

用这个配置替换原文件，然后运行nginx -t和启动命令，如果没问题，说明原配置里有其他冲突项。

4. 检查Nginx的编译参数 #

虽然可能性很低，但你可以看看nginx -V的输出，确认有没有禁用核心模块的参数（比如--without-http_core_module）。不过如果真的禁用了核心模块，Nginx根本无法正常运行，所以这个情况大概率不会出现。

临时替代方案 #

如果暂时排查不出原因，你可以用更早版本就支持的$request_length变量替代，它的含义和$bytes_received几乎一致（都是客户端发送的总字节数，包含请求头和请求体）：

log_format postdata '$remote_addr sent $request_length bytes';

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