go语言优雅关机和优雅重启笔记

news2025/4/21 7:27:07

一、优雅关机

生活化例子
- 餐馆关门：你去餐馆吃火锅，刚坐下点完菜（客户端发请求），餐馆老板突然接到通知要停电（收到关机指令）。老板很贴心，先停止接待新客人（停止接收新请求），等你这桌和其他正在吃饭的客人（正在处理的请求）都吃完了，再关门走人。这样你的火锅就能安安全全吃完，不会有任何损失。
代码示例

package main

import (
	"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和系统终止信号

	// 阻塞等待信号
	<-quit
	log.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("服务器已安全退出")
}

验证效果
1. 运行上面的代码，启动服务。
2. 打开浏览器访问 http://127.0.0.1:8080/cook-hotpot，模拟开始煮火锅。
3. 在终端迅速执行 Ctrl+C 命令，向程序发送关机信号。
4. 观察程序不会立即退出，而是等待火锅煮好（请求处理完）后才退出，实现优雅关机。

二、优雅重启

生活化例子
- 保安换班：小区门口有两名保安，保安A（老进程）正在值班，保安B（新进程）来接班。保安A不会直接走人，而是等手头的事（比如处理一辆正在进入的车）忙完，再让保安B接管工作。这样小区门口的秩序不会因为换班而受到影响。
代码示例

package main

import (
	"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("服务器已安全退出")
}

验证效果
1. 编译并运行上述代码，终端会输出当前进程的 PID。
2. 修改代码中处理请求函数的返回值，如将 "你好呀，欢迎来到小区！" 修改为 "欢迎光临，小区新保安在此！"，然后重新编译。
3. 打开浏览器访问 http://127.0.0.1:8080/greet，模拟车辆进入小区。
4. 在终端迅速执行 kill -1 <PID> 命令，向程序发送优雅重启信号。
5. 等当前请求处理完（保安A处理完手头的事），再次访问时会收到新的欢迎语，说明在不影响当前请求的情况下完成了优雅重启，同时进程号也变成了新的（保安B接班）。