Nginx 502 Bad Gateway错误：Flask应用域名跳转失败排查

我的Flask Web应用运行在http://191.101.1.48:5000，域名itrendsolution.org已正确指向该IP，但访问域名时弹出「502 Bad Gateway error nginx」错误。我用CloudPanel部署这个应用，关联了MySQL数据库，已经配置Nginx通过反向代理把HTTPS请求转发到5000端口的HTTP应用，SSL证书也部署好了，但问题还是没解决。需要实现将http://191.101.1.48:5000映射到https://191.101.1.48或itrendsolution.org。

当前使用的Nginx配置：

server {
    listen 80;
    server_name itrendsolution.org www.itrendsolution.org;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl;
    server_name itrendsolution.org www.itrendsolution.org;

    ssl_certificate /etc/letsencrypt/live/itrendsolution.org/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/itrendsolution.org/privkey.pem;

    location / {
        proxy_pass http://191.101.1.48:5000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

    # Additional SSL settings
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_prefer_server_ciphers off;
    ssl_ciphers 'TLS_AES_128_GCM_SHA256:TLS_AES_256_GCM_SHA384';
    ssl_session_timeout 1d;
    ssl_session_cache shared:MozSSL:10m;
    ssl_session_tickets off;
    ssl_stapling on;
    ssl_stapling_verify on;

    # Additional configurations if needed

    location ~ /\.well-known {
        allow all;
    }
}

排查与解决步骤 #

1. 确认Flask应用正常运行 #

• 在VPS本地执行命令，检查5000端口是否被监听：

  netstat -tulpn | grep :5000
  

  或者用ss命令：

  ss -tulpn | grep :5000
  

  要确保输出里能看到Flask进程（比如python3或gunicorn）绑定在0.0.0.0:5000或191.101.1.48:5000，如果只绑定127.0.0.1:5000，Nginx是无法访问的。

• 本地测试Flask应用是否能正常响应：

  curl http://191.101.1.48:5000
  

  如果返回正常页面内容，说明应用本身没问题；如果超时或无响应，先修Flask应用的启动问题。

2. 检查防火墙/安全组设置 #

• 确保VPS的防火墙（比如ufw、firewalld）或云服务商的安全组允许5000端口的入站请求（Nginx需要访问这个端口），同时要允许80和443端口的入站请求。
• 执行ufw status查看当前防火墙规则，若5000端口未开放，添加规则：

  ufw allow 5000/tcp
  ufw reload
  

3. 调整Nginx反向代理配置 #

如果Flask应用仅绑定127.0.0.1（默认flask run命令常出现这种情况），把proxy_pass改成本地回环地址，同时添加超时配置避免因应用响应慢导致502：

location / {
    proxy_pass http://127.0.0.1:5000;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_connect_timeout 30s;
    proxy_send_timeout 30s;
    proxy_read_timeout 30s;
}

另外，要支持直接通过https://191.101.1.48访问，需要在443端口的server块中添加IP作为server_name：

server {
    listen 443 ssl;
    server_name itrendsolution.org www.itrendsolution.org 191.101.1.48;
    # 其余SSL和代理配置保持不变
}

4. 验证Nginx配置并重启 #

• 检查配置文件语法是否正确：

  nginx -t
  

• 若提示test is successful，重启Nginx服务：

  systemctl restart nginx
  

5. 查看Nginx错误日志定位问题 #

如果以上步骤都没解决，查看Nginx错误日志（通常路径为/var/log/nginx/error.log）：

tail -n 20 /var/log/nginx/error.log

日志里会明确显示502错误的原因，比如连接被拒绝、超时等，根据具体信息再进一步排查。

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