不能直接生效，必须配合信号监听和进程管理逻辑；beego的graceful配置仅控制子进程派生机制，不处理listener复用、超时等待及db/grpc等资源关闭。
beego.BConfig.Listen.Graceful = true 能否直接启用优雅关闭
不能直接生效，必须配合信号监听和进程管理逻辑。Beego 的 Graceful 配置仅控制是否启用基于 SIGUSR2（旧版）或 SIGHUP（1.12+）的子进程派生机制，它本身不接管 shutdown 流程，也不处理 listener 复用、文件描述符传递、超时等待等关键环节。
常见错误现象：Graceful = true 后执行 kill -HUP $pid，旧进程立刻退出，新进程启动失败报 address already in use；或旧进程卡住不退出，新请求全部被拒绝。
- Beego 1.12 之前默认监听
SIGUSR2，之后改为SIGHUP，需确认你使用的 Beego 版本（beego.VERSION） -
Graceful = true仅在调用beego.Run()前设置才有效，运行中修改无效 - 该模式下 Beego 会 fork 新进程并尝试复用 listener，但不保证跨平台兼容（Windows 不支持 fork）
- 它不提供 shutdown 超时控制，也没有对 DB/Redis/gRPC 等资源的优雅关闭钩子
如何手动接管 http.Server 实现可控 shutdown
放弃 beego.Run()，改用显式构造 *http.Server 并保存实例引用——这是唯一能真正控制生命周期的方式。Beego 的 App 和 Controller 仍可照常使用，只需把路由注册到自定义 server 中。
实操建议：
- 用
beego.NewApp()获取应用实例，再通过app.Handlers拿到http.Handler - 构造
&http.Server{Addr: ":8080", Handler: app.Handlers}，**必须保留该变量引用** -
srv.ListenAndServe()必须放在 goroutine 中启动，否则主流程阻塞，无法响应信号 - 用
signal.Notify(quit, os.Interrupt, syscall.SIGTERM)监听中断信号，收到后调用srv.Shutdown(ctx) - 超时建议设为 10 秒：
ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)，超时后应 fallback 到srv.Close()
beego.Router 与中间件是否支持 context 取消
Beego 默认不透传 context.Context 到 Controller 方法，所有 handler（如 Get()、Post()）都是无参的，因此无法原生响应 ctx.Done()。这意味着即使你正确调用了 Shutdown()，正在执行的 DB 查询、HTTP 调用或 sleep 仍会阻塞，导致 shutdown 超时失败。
解决路径有限但明确：
- 在 Controller 中手动检查
this.Ctx.Input.Context().Done()，并在关键阻塞点（如db.QueryContext()、http.Client.Do(req.WithContext())）传入该 context - 避免在
Prepare()或Finish()中做长耗时操作，它们不接收 context 参数 - Beego 的日志、session、cache 模块均未适配 context 取消，若需强保障，应自行封装带 cancel 的 wrapper
- 不要依赖
beego.BeeLogger的异步写入来“躲过 shutdown”，它可能丢日志
开发期热编译 vs 生产环境优雅重启的区别
开发期用 bee run 是进程级替换：旧进程被 os.Kill 强制终止，无任何 graceful 行为；生产环境重启必须绕过端口占用、复用 listener、等待请求完成——二者技术路径完全不同，不可混用。
容易被忽略的关键点：
-
bee run的热编译只适合本地调试，它生成的是临时二进制，不包含 listener fd 传递逻辑，也无信号转发能力 - 生产部署必须用编译后的静态二进制，配合
gracehttp或自研 launcher 管理子进程生命周期 - Beego 的
Graceful模式本质是“fork + exec”，它不 reload 代码，而是启动全新进程，因此要求新二进制已就位（不能指望它自动构建） - 如果你用容器部署（如 Docker），
SIGHUP默认不被转发，需显式配置docker run --init或使用 tini
