导航：首页 > 开发技术 >

golang怎么优雅的关机或重启

发表于：2025-01-22 作者：千家信息网编辑

千家信息网最后更新 2025年01月22日，本文小编为大家详细介绍"golang怎么优雅的关机或重启"，内容详细，步骤清晰，细节处理妥当，希望这篇"golang怎么优雅的关机或重启"文章能帮助大家解决疑惑，下面跟着小编的思路慢慢深入，一起来学习

千家信息网最后更新 2025年01月22日golang怎么优雅的关机或重启

本文小编为大家详细介绍"golang怎么优雅的关机或重启"，内容详细，步骤清晰，细节处理妥当，希望这篇"golang怎么优雅的关机或重启"文章能帮助大家解决疑惑，下面跟着小编的思路慢慢深入，一起来学习新知识吧。

优雅地关机或重启

我们编写的Web项目部署之后，经常会因为需要进行配置变更或功能迭代而重启服务，单纯的kill -9 pid的方式会强制关闭进程，这样就会导致服务端当前正在处理的请求失败，那有没有更优雅的方式来实现关机或重启呢？

阅读本文需要了解一些UNIX系统中信号的概念，请提前查阅资料预习。

优雅地关机

什么是优雅关机？

优雅关机就是服务端关机命令发出后不是立即关机，而是等待当前还在处理的请求全部处理完毕后再退出程序，是一种对客户端友好的关机方式。而执行Ctrl+C关闭服务端时，会强制结束进程导致正在访问的请求出现问题。

如何实现优雅关机？

Go 1.8版本之后， http.Server 内置的 Shutdown() 方法就支持优雅地关机，具体示例如下：

// +build go1.8package mainimport (        "context"        "log"        "net/http"        "os"        "os/signal"        "syscall"        "time"        "github.com/gin-gonic/gin")func main() {        router := gin.Default()        router.GET("/", func(c *gin.Context) {                time.Sleep(5 * time.Second)                c.String(http.StatusOK, "Welcome Gin Server")        })        srv := &http.Server{                Addr:    ":8080",                Handler: router,        }        go func() {                // 开启一个goroutine启动服务                if err := srv.ListenAndServe(); err != nil && err != http.ErrServerClosed {                        log.Fatalf("listen: %s\n", err)                }        }()        // 等待中断信号来优雅地关闭服务器，为关闭服务器操作设置一个5秒的超时        quit := make(chan os.Signal, 1) // 创建一个接收信号的通道        // kill 默认会发送 syscall.SIGTERM 信号        // kill -2 发送 syscall.SIGINT 信号，我们常用的Ctrl+C就是触发系统SIGINT信号        // kill -9 发送 syscall.SIGKILL 信号，但是不能被捕获，所以不需要添加它        // signal.Notify把收到的 syscall.SIGINT或syscall.SIGTERM 信号转发给quit        signal.Notify(quit, syscall.SIGINT, syscall.SIGTERM)  // 此处不会阻塞        <-quit  // 阻塞在此，当接收到上述两种信号时才会往下执行        log.Println("Shutdown Server ...")        // 创建一个5秒超时的context        ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)        defer cancel()        // 5秒内优雅关闭服务（将未处理完的请求处理完再关闭服务），超过5秒就超时退出        if err := srv.Shutdown(ctx); err != nil {                log.Fatal("Server Shutdown: ", err)        }        log.Println("Server exiting")}

如何验证优雅关机的效果呢？

上面的代码运行后会在本地的8080端口开启一个web服务，它只注册了一条路由/，后端服务会先sleep 5秒钟然后才返回响应信息。

我们按下Ctrl+C时会发送syscall.SIGINT来通知程序优雅关机，具体做法如下：

打开终端，编译并执行上面的代码
打开一个浏览器，访问127.0.0.1:8080/，此时浏览器白屏等待服务端返回响应。
在终端迅速执行Ctrl+C命令给程序发送syscall.SIGINT信号
此时程序并不立即退出而是等我们第2步的响应返回之后再退出，从而实现优雅关机。

优雅地重启

优雅关机实现了，那么该如何实现优雅重启呢？

我们可以使用 fvbock/endless 来替换默认的 ListenAndServe启动服务来实现，示例代码如下：

package mainimport (        "log"        "net/http"        "time"        "github.com/fvbock/endless"        "github.com/gin-gonic/gin")func main() {        router := gin.Default()        router.GET("/", func(c *gin.Context) {                time.Sleep(5 * time.Second)                c.String(http.StatusOK, "hello gin!")        })        // 默认endless服务器会监听下列信号：        // syscall.SIGHUP，syscall.SIGUSR1，syscall.SIGUSR2，syscall.SIGINT，syscall.SIGTERM和syscall.SIGTSTP        // 接收到 SIGHUP 信号将触发`fork/restart` 实现优雅重启（kill -1 pid会发送SIGHUP信号）        // 接收到 syscall.SIGINT或syscall.SIGTERM 信号将触发优雅关机        // 接收到 SIGUSR2 信号将触发HammerTime        // SIGUSR1 和 SIGTSTP 被用来触发一些用户自定义的hook函数        if err := endless.ListenAndServe(":8080", router); err!=nil{                log.Fatalf("listen: %s\n", err)        }        log.Println("Server exiting")}

如何验证优雅重启的效果呢？

我们通过执行kill -1 pid命令发送syscall.SIGINT来通知程序优雅重启，具体做法如下：

打开终端，go build -o graceful_restart编译并执行./graceful_restart,终端输出当前pid(假设为43682)
将代码中处理请求函数返回的hello gin!修改为hello q1mi!，再次编译go build -o graceful_restart
打开一个浏览器，访问127.0.0.1:8080/，此时浏览器白屏等待服务端返回响应。
在终端迅速执行kill -1 43682命令给程序发送syscall.SIGHUP信号
等第3步浏览器收到响应信息hello gin!后再次访问127.0.0.1:8080/会收到hello q1mi!的响应。
在不影响当前未处理完请求的同时完成了程序代码的替换，实现了优雅重启。