echo框架需绑定127.0.0.1避免公网暴露，nginx负责负载均衡；upstream须用127.0.0.1而非localhost；proxy_pass末尾加/防止路径错乱；必须启用recover中间件并配置nginx重试机制以实现真均衡。
Go 的 Echo 框架本身不参与负载均衡，所有分发逻辑必须由 Nginx 控制；你写的 Echo 代码里加再多配置，也改不了 upstream 行为。
echo.ListenAndServe 必须绑定 127.0.0.1，不能写 0.0.0.0
默认 Echo 启动时若用 :8080，实际等价于 0.0.0.0:8080，服务会直接暴露在公网——绕过 Nginx 的 SSL 终止、限流和访问控制，是生产事故高发点。
- 正确写法：
e.Start("127.0.0.1:8080")或http.ListenAndServe("127.0.0.1:8080", e) - 验证是否生效：运行
ss -tln | grep :8080，输出中应只含127.0.0.1:8080，不含*:8080 - Docker 部署时，在
ENTRYPOINT或启动脚本里显式传入127.0.0.1:8080，别依赖环境变量 fallback
nginx upstream 里 server 地址不能写 localhost
localhost 在容器或 systemd 环境下常被解析为 ::1（IPv6），而你的 Echo 只监听 IPv4 的 127.0.0.1，导致 Nginx 连接被拒绝，日志报 connection refused。
- 统一用
127.0.0.1:8080，不要用localhost:8080或127.0.0.1:8080混写 - 多实例部署时，每个
Echo实例用不同端口（如8081、8082），upstream显式列出 - Swarm/K8s 场景下，用服务名（如
echo-app:8080）替代 IP，Nginx 需启用resolver并配resolve参数
proxy_pass 末尾斜杠决定路径重写行为
漏掉 / 是最常见 404 原因。比如 location /api/ { proxy_pass http://backend; }（无斜杠），Nginx 会把 /api/user 转发成 http://backend/api/user，但 Echo 的路由注册的是 /user，自然 404。
- 推荐统一写法：
proxy_pass http://backend/;（带尾部/） - 此时
location /api/→http://backend/user，Echo路由保持简洁 - 若后端已做 prefix strip（如用
e.Group("/api")），才考虑不加/，但需严格对齐
echo 处理 panic 会影响 Nginx 健康检查
Echo 默认不 recover panic，一次 panic 就让整个进程退出。Nginx 检测到连接失败，按 max_fails=1 fail_timeout=10s 直接剔除节点，用户看到 502。
- 必须加全局中间件：
e.Use(middleware.Recover())（Echo 自带） - 再配合
systemd的Restart=always或容器的restart: always，避免单点崩溃雪崩 -
upstream中补上proxy_next_upstream error timeout http_500 http_502 http_503 http_504，让 Nginx 主动重试
真正难的不是写对几行 upstream，而是让每个 Echo 实例的生命周期、监听地址、panic 恢复、日志上下文，都跟 Nginx 的健康探测节奏对齐——错一个环节，负载就变成“伪均衡”。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
