GoFrame优雅重启需手动接管http.Server生命周期:弃用默认Run,显式构造srv并goroutine启动;监听SIGTERM后调Shutdown(ctx)配超时;确保DB/Redis/gRPC等全链路响应ctx取消;可选endless实现零停机热重启(仅Linux/macOS)。

GoFrame框架中实现优雅重启需绕过其默认阻塞式启动,手动接管http.Server生命周期,否则收到SIGTERM时连接直接RST中断、事务未提交、SSE断连、大文件上传失败全都会发生。
替换默认Run,显式构造http.Server
放弃gf.Gf().Run()或server.Start()等封装方法,改用标准库http.Server手动启动。
复制以下结构,把你的ghttp.Server实例赋给Handler字段:
srv := &http.Server{Addr: ":8080", Handler: yourGfServer};
go func() { if err := srv.ListenAndServe(); err != nil && err != http.ErrServerClosed { log.Fatal(err) } }()。
【必须保留srv变量引用】 后续Shutdown()全靠它,一旦丢弃就彻底失去控制权。
启动必须放在goroutine里——否则ListenAndServe()永久阻塞主线程,信号监听逻辑根本不会执行。
监听SIGTERM并触发带超时的Shutdown
使用signal.Notify注册os.Interrupt和syscall.SIGTERM,不要加SIGHUP——Kubernetes和systemd默认不转发它,加了等于白配。
收到信号后,立即调用srv.Shutdown(),但必须传入带超时的context:
ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second)
defer cancel()
if err := srv.Shutdown(ctx); err != nil { log.Printf("shutdown error: %v", err) }。
超时时间不能拍脑袋定:若业务平均响应耗时3秒,设1秒超时必然强杀连接,返回502;设60秒又可能拖垮发布流程。建议按P99延迟×2再上浮10秒。
忽略http.ErrServerClosed错误——这是Shutdown()成功触发后的正常返回值,不是异常,panic或log.Fatal会直接干掉进程。
确保所有资源响应上下文取消
第一步:检查所有数据库操作是否用了QueryContext、ExecContext而非裸Query/Exec;第二步:确认Redis客户端、HTTP client、gRPC调用都传入了request.Context()或自定义ctx;第三步:所有长轮询、SSE handler必须监听w.(http.Flusher).Flush()前的ctx.Done()。
没做这三步,Shutdown()超时后仍有goroutine卡住,最终被OS强制kill,日志里出现"sql: transaction has already been committed or rolled back"就是典型症状。
GoFrame中间件本身不自动透传ctx,你得在自定义中间件里显式从r.Context()取值,并向下传递。
用endless实现真正的零停机热重启(Linux/macOS限定)
方法一:引入github.com/fvbock/endless,替换原生ListenAndServe:
endless.ListenAndServe(":8080", yourGfServer)。
方法二:必须禁用Windows环境——endless依赖Unix fork系统调用,Windows下直接panic。
方法三:收到SIGUSR2后,新进程启动,旧进程等待活跃连接自然结束;若连接卡死,45秒后DefaultHammerTime强制终结——这个时间不可修改,硬编码在源码里。
【不能提前调用os.Exit()或panic】 否则fork流程被破坏,子进程无法继承监听socket,lsof查不到双进程共用端口,重启瞬间全量断连。

















