服务关停是高频运维动作：发布、扩缩容、故障迁移都会触发。目标是：停止接收新请求、完成正在处理的请求、最后干净退出。

核心思路很简单：

  1. 监听系统信号
  2. 收到信号后进入“停止接收新请求”状态
  3. 给现有请求一个超时时间，优雅退出

Go 标准库已经提供了优雅关停的方法，配合 context 就够用。

示例

package main

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

func newServer() *http.Server {
	mux := http.NewServeMux()
	mux.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
		w.WriteHeader(http.StatusOK)
		_, _ = w.Write([]byte("ok"))
	})

	return &http.Server{
		Addr:         ":6969",
		Handler:      mux,
		ReadTimeout:  5 * time.Second,
		WriteTimeout: 10 * time.Second,
		IdleTimeout:  60 * time.Second,
	}
}

func main() {
	srv := newServer()

	// 监听中断信号：Ctrl+C、kill
	ctx, stop := signal.NotifyContext(context.Background(), os.Interrupt, syscall.SIGTERM)
	defer stop()

	// 启动服务
	go func() {
		log.Println("server started")
		if err := srv.ListenAndServe(); err != nil && err != http.ErrServerClosed {
			log.Fatalf("listen: %v", err)
		}
	}()

	// 等待信号
	<-ctx.Done()
	log.Println("shutdown signal received")

	// 进入优雅关闭
	shutdownCtx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
	defer cancel()

	if err := srv.Shutdown(shutdownCtx); err != nil {
		log.Printf("shutdown error: %v", err)
		if err := srv.Close(); err != nil {
			log.Printf("force close error: %v", err)
		}
	}

	log.Println("server exited")
}

关键点说明

  • Shutdown 会停止接收新连接，并等待已有连接处理完成。
  • context.WithTimeout 防止请求永远不退出，超时后会强制关闭。
  • ReadTimeout/WriteTimeout/IdleTimeout 能避免慢请求拖死关停。
  • 如果你有后台协程（worker、队列消费），也要在同一个 context 下做退出逻辑。

小结：优雅关停是“收口 + 等待 + 超时兜底”。把流程收敛到一个 context 里，最不容易踩坑。