Nginx返回502的主因是upstream中配置了未运行或端口不通的服务节点，且Flask默认监听127.0.0.1导致Nginx无法代理，须改为host='0.0.0.0'并放行端口。
Flask应用启动多个实例时，为什么直接访问Nginx返回502？
常见原因是Nginx的upstream里配置了未运行或端口不通的服务节点。Flask默认用app.run(host='127.0.0.1', port=5000)，只监听本地回环，外部Nginx无法代理转发。必须显式改为host='0.0.0.0'，且确保防火墙放行对应端口（如5001、5002）。
实操建议：
- 每个Flask实例用不同端口启动：
python app.py --port 5001、python app.py --port 5002 - 在代码中读取
--port参数，并传给app.run(host='0.0.0.0', port=port) - 用
curl http://127.0.0.1:5001/health逐个验证服务可访问，再配Nginx - 避免用
localhost代替127.0.0.1——某些系统下localhost解析为IPv6地址，导致Nginx连接失败
upstream块里怎么设置权重（weight）并验证是否生效？
权重只在least_conn和默认轮询（round-robin）策略下起作用；在ip_hash或hash $request_uri等哈希策略下会被忽略。Nginx不会动态感知后端健康状态，weight只是静态分配比例。
示例配置片段：
立即学习“Python免费学习笔记（深入）”；
upstream flask_cluster {
server 127.0.0.1:5001 weight=3;
server 127.0.0.1:5002 weight=1;
server 127.0.0.1:5003 weight=2;
}
验证方法：
python-script-generator
下载
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
- 用
ab -n 1000 -c 100 http://your-domain/api/test压测，再查各Flask进程的请求计数（比如在Flask里用全局变量+线程锁统计） - 观察比例是否接近 3:1:2（允许小偏差，因Nginx内部调度非严格按请求次序）
- 注意：weight不等于QPS占比，实际受后端响应时间影响——慢节点即使weight高，也会被Nginx临时降权（需配合
max_fails/fail_timeout）
如何让Nginx自动剔除挂掉的Flask实例？
Nginx本身不主动探测健康状态，必须靠被动检测（基于请求失败）或主动健康检查（仅商业版Nginx Plus支持）。开源版常用组合是：max_fails + fail_timeout + 自定义location /health端点。
Flask端需提供轻量健康接口：
@app.route('/health')
def health():
return {'status': 'ok'}, 200
Nginx upstream配置增强：
upstream flask_cluster {
server 127.0.0.1:5001 weight=3 max_fails=3 fail_timeout=30s;
server 127.0.0.1:5002 weight=1 max_fails=3 fail_timeout=30s;
keepalive 32;
}
关键点：
-
max_fails=3表示连续3次请求超时或返回5xx即标记为不可用 -
fail_timeout=30s指30秒内不向该节点发新请求，30秒后尝试恢复 - 必须在
location里显式触发健康检查，例如：proxy_pass_request_headers off;+proxy_set_header Host "";避免把/health请求透传到业务逻辑 - 开源Nginx无法做TCP层心跳，所以依赖HTTP层面的失败反馈——如果Flask进程卡死但端口仍通，Nginx无法识别
为什么加了upstream后，Flask里request.remote_addr变成127.0.0.1？
因为Nginx作为反向代理，默认把客户端真实IP丢弃，只传127.0.0.1给后端。Flask拿到的remote_addr是Nginx本机地址，不是用户IP。
修复方式分两步：
- Nginx配置中添加：
proxy_set_header X-Real-IP $remote_addr;和proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; - Flask代码中改用
request.headers.get('X-Real-IP')或request.headers.get('X-Forwarded-For').split(',')[0].strip() - 注意：
X-Forwarded-For可被伪造，若Nginx不在最外层（比如前面还有CDN），应信任X-Real-IP或配置set_real_ip_from指令 - 别漏掉
proxy_set_header Host $host;，否则Flask生成URL（如url_for）可能出错
upstream看似简单，但权重、健康检测、IP透传三者相互影响。最容易被忽略的是：没有验证每个Flask实例是否真的在0.0.0.0监听，以及没意识到ip_hash会完全无视weight。线上部署前，务必用netstat -tuln | grep :500确认端口绑定状态。 
