beego优雅停机失效主因是容器pid 1非beego进程：若dockerfile用sh -c启动导致shell占pid 1，sigterm无法转发；须改用cmd ["./app"]或tini init，并确认graceful=true在beego.run()前设置。
Beego 应用在容器里被 SIGTERM 杀掉却立刻退出、连接被重置、日志里看不到“正在等待请求完成”，说明优雅停机根本没生效——这不是 Beego 的 bug，而是容器环境没配对。
beego.BConfig.Listen.Graceful = true 为什么在容器里常失效
这个配置本身有效，但前提是进程必须能收到 SIGTERM，且是 PID 1 进程直接响应。而多数 Dockerfile 用 sh -c "./app" 或 bash -c "exec ./app" 启动，导致 shell 占了 PID 1，它不转发信号，SIGTERM 到不了 Beego 进程。
- 检查当前容器内 PID 1 是什么：
ps -o pid,comm 1，如果输出是sh或bash，就踩坑了 - Beego 的优雅模式只监听
SIGTERM（不是SIGHUP），kill -HUP在容器场景下无意义 -
Graceful = true必须在beego.Run()之前设置，放在init()或main()开头最稳妥，别依赖app.conf的Graceful=true—— 它只影响部分旧版本，且加载时机不可控
Docker 镜像必须用 exec 模式启动 Beego 进程
确保 Beego 二进制文件是容器中真正的 PID 1，否则信号链断开。Dockerfile 中禁止出现 sh -c 或 bash -c 包裹启动命令。
- ✅ 正确写法（使用 exec 格式）：
CMD ["./dochub"]或ENTRYPOINT ["./dochub"] - ❌ 错误写法：
CMD sh -c "./dochub"、ENTRYPOINT ["sh", "-c", "./dochub"] - 如果必须做环境准备（如生成配置），用最小化 init 工具：加
RUN apk add --no-cache tini，再设ENTRYPOINT ["tini", "--", "./dochub"]，tini会正确转发信号
验证优雅停机是否真在工作
光看进程退出不叫验证。要确认它是否真的等完了请求，得看三件事：信号接收、连接关闭行为、超时兜底。
- 启动时加日志：在
main()里加log.Println("graceful mode enabled:", beego.BConfig.Listen.Graceful)，确认值为true - 模拟请求并发送
kill -15 $PID，观察：- 应用是否打印类似
Stopping server, waiting for connections to finish...的日志（Beego 内置） - 用
ss -tuln | grep :8090看端口是否立即消失（不应立刻消失） - 用
curl -v http://localhost:8090/health在 kill 后几秒内发请求，应仍能成功返回，直到超时
- 应用是否打印类似
- Beego 默认等待 60 秒（
GracefulDeadline），可通过beego.BConfig.Listen.GracefulDeadline = 30缩短；Kubernetes 的terminationGracePeriodSeconds必须 ≥ 这个值，否则会被强制SIGKILL
GOMEMLIMIT 和 GOMAXPROCS 不影响优雅停机，但影响它能否跑完
这两个环境变量不参与信号处理逻辑，但若设错，会导致进程在等待阶段因 OOM 被杀，或因 CPU 抢占严重拖慢请求处理，让 graceful deadline 形同虚设。
-
GOMEMLIMIT应设为容器内存 limit 的 80%～90%，例如 limit=512Mi →GOMEMLIMIT=450Mi，给 runtime 堆外内存（线程栈、mmap、CGO）留余地 -
GOMAXPROCS应设为容器 CPU limit 值（整数），例如limits.cpu: "2"→GOMAXPROCS=2；不设则默认读宿主机核数，引发过度调度，拖慢请求收尾 - 务必在容器启动时通过
env注入，而非在 Go 代码里调用runtime.GOMAXPROCS()—— 它晚于运行时初始化，无效
真正卡住优雅停机的，往往不是 Beego 配置，而是数据库连接没关、RabbitMQ consumer goroutine 没停、或者某个阻塞的 http.Serve() 调用没退出。这些都得靠你自己的 os.Signal 监听 + sync.WaitGroup + context.WithTimeout 来兜底，Beego 只管 HTTP Server 层。
