Go语言如何在Web服务中实现优雅关机

 更新时间:2024年11月15日 10:34:34   作者:左诗右码  
在这篇文章中,我们将通过一个简单的例子来演示如何在 Go 语言中使用 Gin 框架实现优雅关机,感兴趣的小伙伴可以跟随小编一起学习一下

在构建 Web 服务时,我们往往会遇到一个棘手的问题:当我们想要停止服务时,如何确保正在处理的请求能够顺利完成,而不是突然中断? 这种技术被称为“优雅关机”,它可以确保在服务关闭时,所有的请求都被妥善处理。

在这篇文章中,我们将通过一个简单的例子来演示如何在 Go 语言中使用 Gin 框架实现优雅关机。

什么是优雅关机?

优雅的关机是指在关闭服务之前,先让服务处理完当前正在处理的请求,然后再关闭服务。这样可以保证服务不会丢失请求,也不会影响到正在处理的请求。这种方式可以提高用户体验,防止服务中断造成的数据丢失或不一致。 而执行 Ctrl + C 或者 kill -2 pid 命令关闭服务,是不会等待服务处理完请求的,这样就会导致服务丢失请求。

如何实现优雅的关机?

Go 1.8 版本之后,http.Server 内置的 Shutdown() 方法就支持优雅地关机。

代码实现

我们来看一个具体的代码示例,通过这个例子我们将展示如何实现优雅关机。

package main

import (
	"context"
	"log"
	"net/http"
	"os"
	"os/signal"
	"syscall"
	"time"

	"github.com/gin-gonic/gin"
)

func main() {
	router := gin.Default()

	// 定义一个简单的路由
	router.GET("/ping", func(c *gin.Context) {
		// 模拟一个耗时操作,比如数据库查询或外部API调用
		time.Sleep(5 * time.Second)
		c.JSON(http.StatusOK, gin.H{
			"message": "pong",
		})
	})

	// 配置 HTTP 服务器
	srv := &http.Server{
		Addr:    ":8080",
		Handler: router,
	}

	// 启动服务器
	go func() {
		if err := srv.ListenAndServe(); err != nil && err != http.ErrServerClosed {
			log.Fatalf("Failed to start server: %v", 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")

}

代码解析

1. 路由定义和服务启动

router := gin.Default()
router.GET("/ping", func(c *gin.Context) {
	time.Sleep(5 * time.Second)
	c.JSON(http.StatusOK, gin.H{
		"message": "pong",
	})
})

首先,我们创建了一个简单的 Gin 路由,并定义了一个 /ping 接口。当访问这个接口时,服务器会模拟一个耗时 5 秒的操作,然后返回一个 JSON 响应。这段代码展示了一个可能需要优雅关机的典型场景:服务器可能正在处理耗时的请求,如果此时直接关机,请求会被中断。

2. HTTP 服务器配置和启动

srv := &http.Server{
	Addr:    ":8080",
	Handler: router,
}

go func() {
	if err := srv.ListenAndServe(); err != nil && err != http.ErrServerClosed {
		log.Fatalf("Failed to start server: %v", err)
	}
}()

我们使用 http.Server 结构体配置并启动了一个 HTTP 服务器。服务器在一个单独的 goroutine 中运行,这样主程序可以继续执行,而不必等待服务器启动完成。

3. 捕获系统信号

quit := make(chan os.Signal, 1)
signal.Notify(quit, syscall.SIGINT, syscall.SIGTERM)

<-quit

为了实现优雅关机,我们需要捕获系统信号。这里使用了 os/signal 包来监听 syscall.SIGINTsyscall.SIGTERM 信号。当用户按下 Ctrl+C 或者通过 kill 命令发送信号时,这些信号会被捕获并发送到 quit 通道,程序会随即从阻塞状态中恢复,继续执行后续代码。

4. 实现优雅关机

ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
defer cancel()

if err := srv.Shutdown(ctx); err != nil {
	log.Fatal("Server Shutdown: ", err)
}

在捕获到关机信号后,我们使用 http.ServerShutdown 方法来实现优雅关机。Shutdown 方法接受一个 context 参数,这个 context 设置了一个超时时间。在这里,我们设置了一个 5 秒的超时时间,意味着服务器将在 5 秒内等待未完成的请求处理完毕,然后关闭。如果超过了设定的超时时间,服务器将退出,程序也会正常结束。

如何验证优雅关机的效果?

要验证优雅关机的效果,可以按照以下步骤操作:

  • 打开终端,运行 go run gin_shutdown.go
  • 打开浏览器,并访问 http://127.0.0.1:8080/ping 此时浏览器应该会白屏等待服务端返回响应
  • 在刚刚打开的终端上迅速按下 Ctrl+C 命令,此时会自动给程序发送 syscall.SIGINT 信号
  • 此时程序并不会立即退出,而是会等上面的第 2 步的响应返回之后再退出,从而实现优雅关机的效果

总结

优雅关机是构建健壮 Web 服务的一个重要技术点,它确保了在服务关闭时所有正在处理的请求都能被妥善完成。在本文中,我们通过 Gin 框架演示了如何在 Go 中实现优雅关机。通过这种方式,我们可以提升用户体验,减少由于服务中断导致的各种潜在问题。

到此这篇关于Go语言如何在Web服务中实现优雅关机的文章就介绍到这了,更多相关Go优雅关机内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Golang实现http server提供压缩文件下载功能

    Golang实现http server提供压缩文件下载功能

    这篇文章主要介绍了Golang实现http server提供压缩文件下载功能,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2021-01-01
  • go通过编码缩短字符串的长度实现方法步骤

    go通过编码缩短字符串的长度实现方法步骤

    这篇文章主要为大家介绍了go通过编码缩短字符串的长度实现方法步骤,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2024-01-01
  • 浅析Golang中类型嵌入的简介与使用

    浅析Golang中类型嵌入的简介与使用

    类型嵌入指的就是在一个类型的定义中嵌入了其他类型,Go 语言支持两种类型嵌入,分别是接口类型的类型嵌入和结构体类型的类型嵌入,下面我们就来详细一下类型嵌入的使用吧
    2023-11-11
  • 一文带你深入了解Go语言中切片的奥秘

    一文带你深入了解Go语言中切片的奥秘

    切片是数组的一个引用,因此切片是引用类型。但自身是结构体,值拷贝传递。本文将通过示例带大家一起探索一下Go语言中切片的奥秘,感兴趣的可以了解一下
    2022-11-11
  • Go语言编程中对文件读写的基本方法整理

    Go语言编程中对文件读写的基本方法整理

    这篇文章主要介绍了Go语言编程中对文件读写的基本方法整理,是Go语言入门学习中的基础知识,需要的朋友可以参考下
    2015-10-10
  • Go中Vendo机制的使用

    Go中Vendo机制的使用

    自Go1.6起,Go语言正式启用vendor机制,允许将项目依赖放入项目内的vendor目录,类似私有GOPATH,本文就来介绍一下Vendo机制的使用,感兴趣的可以了解一下
    2024-10-10
  • 基于golang时间转换的问题

    基于golang时间转换的问题

    下面小编就为大家带来一篇基于golang时间转换的问题。小编觉得挺不错的,现在就分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-08-08
  • golang之log rotate详解

    golang之log rotate详解

    下面小编就为大家带来一篇golang之log rotate详解。小编觉得挺不错的,现在就分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-06-06
  • golang如何使用gomobile进行Android开发

    golang如何使用gomobile进行Android开发

    golang可以开发android,使用golang开发android需要下载安装gomobile,下面这篇文章主要给大家介绍了关于golang如何使用gomobile进行Android开发的相关资料,需要的朋友可以参考下
    2023-01-01
  • Golang实现单元测试中的逻辑层

    Golang实现单元测试中的逻辑层

    前面我们完成了最麻烦的数据层的单元测试,今天我们来看看单元测试中最容易做的一层,数据逻辑层,也就是我们通常说的 service 或者 biz 等
    2023-03-03

最新评论