在 nginx 中实现加权轮询并记录详细转发日志，核心做法是定义 upstream 块并使用 weight 参数配置权重，同时在 http 或 server 块中通过 log_format 自定义包含上游地址的日志格式。这样每次请求都会将目标后端 ip 和端口写入访问日志，便于追踪流量分布。
如何配置 upstream 实现加权轮询
要启用加权轮询，需在 upstream 块中列出后端服务器并为每台机器指定 weight 值，权重越高被选中的概率越大。默认情况下 Nginx 使用平滑加权轮询算法，确保高权重节点不会在短时间内过载。配置完成后，Nginx 会根据权重比例分配请求，并在内部维护一个动态权重状态。
upstream backend_pool {
server 192.168.1.10:8080 weight=5;
server 192.168.1.11:8080 weight=3;
server 192.168.1.12:8080 weight=2;
}
server {
listen 80;
location / {
proxy_pass http://backend_pool;
}
}
上述配置中，192.168.1.10 获得 50% 的请求，192.168.1.11 获得 30%，192.168.1.12 获得 20%。Nginx 会自动处理权重归一化，无需手动计算比例。若某台后端宕机，Nginx 会将其从轮询列表中移除，直到恢复健康检查。
如何自定义日志格式以记录上游信息
为了在日志中看到请求具体发往哪个后端，必须使用 $upstream_addr 变量。该变量记录了实际处理请求的上游服务器地址，包括 IP 和端口。如果请求被重试，该变量会用逗号分隔列出所有尝试的地址。将此变量加入 log_format 即可实现详细追踪。
log_format detailed '$remote_addr - $remote_user [$time_local] '
'"$request" $status $body_bytes_sent '
'"$http_referer" "$http_user_agent" '
'upstream: $upstream_addr';
server {
listen 80;
access_log /var/log/nginx/access.log detailed;
location / {
proxy_pass http://backend_pool;
}
}
应用此配置后，每行日志末尾会显示类似 upstream: 192.168.1.10:8080 的信息。若发生超时并重试，日志可能显示 upstream: 192.168.1.11:8080, 192.168.1.10:8080。结合 $upstream_response_time 可进一步分析各后端性能差异。注意 $upstream_addr 仅在代理请求成功后填充，若连接失败可能为空或仅显示部分地址。
当后端服务器返回错误时日志如何记录
当后端服务器返回 5xx 错误时，$upstream_addr 依然会记录实际接收请求的地址，即使该请求最终导致客户端收到错误响应。这意味着日志能准确反映哪台后端触发了错误，有助于定位故障节点。若启用 proxy_next_upstream，Nginx 可能会自动重试其他后端，此时日志中的 $upstream_addr 会包含多个地址，按尝试顺序排列。
