go语言优雅关机和优雅重启笔记
一、优雅关机
-
生活化例子
-
餐馆关门:你去餐馆吃火锅,刚坐下点完菜(客户端发请求),餐馆老板突然接到通知要停电(收到关机指令)。老板很贴心,先停止接待新客人(停止接收新请求),等你这桌和其他正在吃饭的客人(正在处理的请求)都吃完了,再关门走人。这样你的火锅就能安安全全吃完,不会有任何损失。
-
-
代码示例
package mainimport ("context""log""net/http""os""os/signal""syscall""time""github.com/gin-gonic/gin"
)func main() {// 创建路由器router := gin.Default()router.GET("/cook-hotpot", func(c *gin.Context) {time.Sleep(5 * time.Second) // 模拟煮火锅需要时间c.String(http.StatusOK, "火锅煮好了,可以吃啦!")})// 创建服务器srv := &http.Server{Addr: ":8080",Handler: router,}// 在单独的goroutine中启动服务器go func() {if err := srv.ListenAndServe(); err != nil && err != http.ErrServerClosed {log.Fatalf("服务器监听错误: %s", err)}}()// 创建一个通道来接收系统信号quit := make(chan os.Signal, 1)signal.Notify(quit, syscall.SIGINT, syscall.SIGTERM) // 监听Ctrl+C和系统终止信号// 阻塞等待信号<-quitlog.Println("开始优雅关机...")// 设置一个5秒超时的上下文ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)defer cancel()// 调用Shutdown方法优雅关闭服务器if err := srv.Shutdown(ctx); err != nil {log.Fatalf("服务器优雅关机失败: %s", err)}log.Println("服务器已安全退出")
}
-
验证效果
-
运行上面的代码,启动服务。
-
打开浏览器访问
http://127.0.0.1:8080/cook-hotpot
,模拟开始煮火锅。 -
在终端迅速执行
Ctrl+C
命令,向程序发送关机信号。 -
观察程序不会立即退出,而是等待火锅煮好(请求处理完)后才退出,实现优雅关机。
-
二、优雅重启
-
生活化例子
-
保安换班:小区门口有两名保安,保安A(老进程)正在值班,保安B(新进程)来接班。保安A不会直接走人,而是等手头的事(比如处理一辆正在进入的车)忙完,再让保安B接管工作。这样小区门口的秩序不会因为换班而受到影响。
-
-
代码示例
package mainimport ("log""net/http""time""github.com/fvbock/endless""github.com/gin-gonic/gin"
)func main() {// 创建路由器router := gin.Default()router.GET("/greet", func(c *gin.Context) {time.Sleep(5 * time.Second) // 模拟处理请求需要时间c.String(http.StatusOK, "你好呀,欢迎来到小区!")})// 使用endless启动服务器,支持优雅重启if err := endless.ListenAndServe(":8080", router); err != nil {log.Fatalf("服务器监听错误: %s", err)}log.Println("服务器已安全退出")
}
-
验证效果
-
编译并运行上述代码,终端会输出当前进程的 PID。
-
修改代码中处理请求函数的返回值,如将 "你好呀,欢迎来到小区!" 修改为 "欢迎光临,小区新保安在此!",然后重新编译。
-
打开浏览器访问
http://127.0.0.1:8080/greet
,模拟车辆进入小区。 -
在终端迅速执行
kill -1 <PID>
命令,向程序发送优雅重启信号。 -
等当前请求处理完(保安A处理完手头的事),再次访问时会收到新的欢迎语,说明在不影响当前请求的情况下完成了优雅重启,同时进程号也变成了新的(保安B接班)。
-
三、总结
-
优雅关机和优雅重启的核心就是“有始有终”,不甩手不管正在做的事。
-
优雅关机就像餐馆老板等你吃完火锅再关门,通过监听系统信号(如
Ctrl+C
),调用Shutdown()
方法,停止接收新请求并等待现有请求处理完。 -
优雅重启就像保安换班,使用
endless
库监听特定信号(如SIGHUP
),启动新进程处理新请求,同时让老进程处理完现有请求再退出。 -
在实际项目中,根据需求选择:需要安全关闭服务就用优雅关机;需要更新代码且不影响现网运行就用优雅重启。
自学go语言组件笔记,希望我们可以一起学习!