Python本身不参与Nginx负载均衡逻辑，需启动多个监听不同端口的实例（如8001/8002/8003），由Nginx upstream显式配置server列表并proxy_pass转发；务必禁用debug/reload、处理SIGTERM，并排查502错误源于后端未就绪或防火墙拦截。
Python 本身不直接参与 Nginx 的负载均衡逻辑——Nginx 是反向代理层，Python 应用只是被代理的后端服务。关键在于：让多个 Python Web 进程（如 Flask/FastAPI）监听不同端口或 Unix socket，再由 Nginx 均匀分发请求。
配置多个 Python 实例监听不同端口
单个 Python 进程无法承载高并发，必须启动多个副本。常见做法是用 gunicorn 或 uvicorn 启动多个 worker，并绑定不同端口（如 8001、8002、8003）。
示例（FastAPI + uvicorn）：
uvicorn main:app --host 0.0.0.0 --port 8001 --workers 1 & uvicorn main:app --host 0.0.0.0 --port 8002 --workers 1 & uvicorn main:app --host 0.0.0.0 --port 8003 --workers 1 &
注意：--workers 1 避免单个进程内多 worker 与 Nginx 负载策略冲突；端口不能重复；建议用进程管理器（如 systemd 或 supervisord）而非裸 & 启动。
立即学习“Python免费学习笔记（深入）”；
Nginx upstream 块必须显式定义 server 列表
Nginx 不会自动发现 Python 进程，必须手动在 upstream 块中列出所有后端地址。默认轮询（round-robin），但可加权重、健康检查等。
安全 Python 代码沙箱：在隔离的沙箱中执行任意 Python 代码，预装 requests、NumPy、pandas 库。返回 stdout、stderr。
典型配置片段（/etc/nginx/conf.d/app.conf）：
upstream python_backend {
server 127.0.0.1:8001;
server 127.0.0.1:8002;
server 127.0.0.1:8003;
}
server {
listen 80;
location / {
proxy_pass http://python_backend;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}
-
proxy_pass必须指向upstream名（如http://python_backend），不能写成http://127.0.0.1:8001，否则绕过负载均衡 - 每个
server行默认权重为 1；若某实例性能更强，可加weight=2 - 生产环境建议加
max_fails=3 fail_timeout=30s实现基础健康检测
Python 应用需禁用调试模式并处理 SIGTERM
Flask 的 debug=True、FastAPI 的 reload=True 在多进程下会导致异常重启或端口占用冲突；同时，Nginx 重载或系统重启时，Python 进程若不响应 SIGTERM，会残留僵尸进程。
实操要点：
- 启动命令中移除
--reload、debug=True等开发参数 - 用
gunicorn时通过--graceful-timeout和--timeout控制平滑退出 - 若用
uvicorn+systemd，在 service 文件中配置KillSignal=SIGTERM和TimeoutStopSec=30
常见 502 错误大多源于端口未就绪或防火墙拦截
502 Bad Gateway 是最常遇到的问题，90% 以上不是 Nginx 配置错误，而是后端没起来或连不通。
排查顺序：
- 执行
curl http://127.0.0.1:8001/health（或任意路径），确认单个 Python 实例可访问 - 检查
netstat -tuln | grep :800[1-3]，确保端口处于LISTEN状态 - 确认 SELinux 或 ufw 没有拦截本地回环通信（
127.0.0.1通常不受限，但某些 hardened 系统会限制） - 查看 Nginx error log：
tail -f /var/log/nginx/error.log，里面会明确写 “Connection refused” 还是 “Connection timed out”
真正难调的是长连接场景下的超时级联：Python 的 keepalive_timeout、Nginx 的 proxy_read_timeout、客户端的 idle timeout，三者不匹配就会静默断连。这类问题不会报错，只会偶发请求卡住。
