Nginx配置WebSocket负载均衡遇404错误的问题排查求助

1. 当前配置存在的问题 #

• 注释语法错误：Nginx仅支持#作为注释符号，你在upstream块中使用的//注释会被识别为无效配置，导致websocket上游服务器池无法正确初始化。需将所有//替换为#。
• Host头配置不匹配后端：你设置的proxy_set_header Host $host;会将包含端口4141的localhost:4141作为Host头转发给后端，但你的WebSocket服务器仅配置了匹配localhost或自身端口（如localhost:8080/localhost:5050）的Host规则，导致后端无法识别请求，返回404。建议将Host头改为$proxy_host（自动使用上游服务器的主机端口）或固定值localhost。
• Connection头配置不够灵活：直接写死Connection "upgrade"会导致非WebSocket请求也强制使用该头，建议使用变量兼容多种请求场景，需先添加映射规则再修改头配置。

修正后的配置示例：

# 添加Connection头映射规则，放在server块外
map $http_upgrade $connection_upgrade {
    default upgrade;
    '' close;
}

upstream websocket {
    server localhost:5050; # WebSocket服务器1运行在此
    server localhost:8080; # WebSocket服务器2运行在此
}
server {
    listen      4141;
    server_name localhost; # server_name无需带端口，listen已指定端口

    location / {
        proxy_pass http://websocket;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Host $proxy_host;
        proxy_set_header Connection $connection_upgrade;
    }
}

2. Nginx的详细日志查看 #

Nginx提供两类核心日志用于排查问题：

• 错误日志：默认路径为/var/log/nginx/error.log，是排查配置错误、转发故障的关键日志。若需要更详细的调试信息，可在配置中调整日志级别为debug，示例：

  error_log /var/log/nginx/error.log debug;
  

  注意：debug级别会生成大量日志，问题排查完成后建议改回info或warn级别。
• 访问日志：默认路径为/var/log/nginx/access.log，你已看到基础访问记录。若需要追踪上游服务器的响应状态、转发地址等信息，可自定义日志格式，添加$upstream_addr、$proxy_status等变量。

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