echo.Server.Shutdown()必须配合context.WithTimeout使用，否则会无限等待连接关闭导致卡死；超时值应略小于K8s terminationGracePeriodSeconds（如25s），且cancel需在Shutdown后立即调用而非defer。
echo.Server.Shutdown() 必须配合 context.WithTimeout 使用
直接调用 echo.Server.Shutdown() 不会自动超时，它会无限等待所有活跃连接关闭——这在生产环境极易导致进程卡死、Kubernetes 强制发送 SIGKILL。必须显式传入带超时的 context.Context，否则 Shutdown() 本身不阻塞，但后续逻辑可能因未清理而泄漏。
常见错误是写成 ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second); defer cancel()，但若 Shutdown() 耗时超过 30 秒，defer cancel() 会在函数退出时才触发，此时 ctx 已失效，Shutdown 内部无法感知超时。
- 正确做法：在调用
Shutdown()前就创建 ctx，并确保 cancel 在 Shutdown 完成后立即调用（不 defer） - 超时时间建议设为略小于 Kubernetes 的
terminationGracePeriodSeconds（默认 30s），例如 25s - 若服务依赖数据库长连接或流式响应，需额外检查中间件是否支持 ctx 透传
echo.NewHTTPServer() 启动前要注册 signal.Notify
Go 标准库不会自动监听 SIGTERM 或 SIGINT，Echo 本身也不内置信号捕获。不手动配置，收到 kill -15 $PID 或 Ctrl+C 时，进程会立刻退出，跳过 Shutdown 流程。
典型漏点是把 signal.Notify 放在 go srv.Start() 之后——此时监听器已启动，新连接正在涌入，但信号通道还没 ready，导致首条信号被丢弃或延迟响应。
立即学习“go语言免费学习笔记（深入）”；
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
- 必须在
srv.Start()之前初始化quit := make(chan os.Signal, 1)并调用signal.Notify(quit, os.Interrupt, syscall.SIGTERM) - 不要监听
SIGHUP或SIGUSR2：前者在 systemd 下不可靠，后者是平滑重启专用，和优雅关闭无关 - Kubernetes 场景下，
SIGTERM是唯一应监听的信号；os.Interrupt仅用于本地开发调试
中间件不支持 context 取消会导致 graceful 失效
哪怕 Shutdown() 正常触发，如果某个中间件（如自定义日志、JWT 验证、数据库查询）内部阻塞在无 ctx 的 I/O 上（比如 db.QueryRow() 而非 db.QueryRowContext(ctx, ...)），整个 Shutdown 就会卡住，直到该操作自然完成或超时。
Echo 默认中间件（如 Logger、Recover）不阻塞，但业务中间件极易踩坑。现象是：收到 SIGTERM 后，lsof -i :8080 显示连接数缓慢下降，甚至停滞在几个长连接上。
- 所有涉及网络、数据库、文件、HTTP client 调用的地方，必须使用带
Context的变体函数（DoWithContext、QueryRowContext等） - 避免在中间件中启动无取消机制的 goroutine（如
go func(){ ... }()） - 可加临时诊断：在 Shutdown 前打印
srv.Listener.Addr().String()和当前活跃连接数（需自定义 listener 包装）
echo.Server.Addr 为空字符串时 Serve() 会 panic
这个错误只在「平滑重启」场景出现，但常被误认为是优雅关闭问题。当用 net.FileListener 复用父进程 fd 启动子进程时，若仍保留 srv.Addr = ":8080"，srv.Serve(ln) 会尝试重新 bind，报错 address already in use，并 panic。
注意：此问题与 Shutdown() 无关，是子进程启动阶段的配置错误。但因发生在优雅关闭流程的下游（父进程 Shutdown 后子进程才起），排查时容易混淆。
- 子进程启动时，必须将
srv.Addr设为空字符串""，否则server.Serve()会拒绝接受已绑定的 listener - 父进程传递 fd 后，子进程应通过
os.NewFile(3, "")+net.FileListener()构建 listener，而非调用net.Listen() - echo 框架无特殊封装，所有操作都基于标准
http.Server，因此复用逻辑与 net/http 完全一致
