信号驱动的优雅停机

示例说明

容器化部署里 SIGTERM 是编排器的标准停机通知，直接退出的进程会把在途请求拦腰截断。signal.NotifyContext 把信号变成 context 取消——主协程阻塞等待，收到信号后进入排空阶段。Shutdown 的语义正合适：停止接受新连接、等待存量请求完成，context 超时则强制收尾，宽限期可控有上限。

技术要点

• NotifyContext 把信号转成上下文取消
• Shutdown 排空在途请求不收新的
• 带超时的排空窗口防无限等待

代码解读

服务器在独立协程里监听，ErrServerClosed 是 Shutdown 的正常返回要排除；主协程等 ctx 完成后，用二十五秒上限的排空 context 调 Shutdown。排空期间健康探针已不可达，负载均衡自然摘流量。强制关闭的兜底错误只记日志——此时进程即将退出。

使用建议

排空窗口要小于编排器的终止宽限。后台任务与连接池也要纳入停机清单。健康探针失败引导摘流是排空生效的前提。

代码示例

package main

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

func main() {
	mux := http.NewServeMux()
	mux.HandleFunc("/healthz", func(w http.ResponseWriter, r *http.Request) {
		fmt.Fprintln(w, "ok")
	})

	srv := &http.Server{
		Addr:              ":8080",
		Handler:           mux,
		ReadHeaderTimeout: 5 * time.Second,
	}

	ctx, stop := signal.NotifyContext(
		context.Background(), syscall.SIGTERM, syscall.SIGINT,
	)
	defer stop()

	go func() {
		if err := srv.ListenAndServe(); err != nil && !errors.Is(err, http.ErrServerClosed) {
			log.Fatalf("serve: %v", err)
		}
	}()

	<-ctx.Done() // 阻塞直到收到终止信号
	log.Println("shutdown signal received, draining")

	shutdownCtx, cancel := context.WithTimeout(context.Background(), 25*time.Second)
	defer cancel()

	if err := srv.Shutdown(shutdownCtx); err != nil {
		log.Printf("forced close after deadline: %v", err)
	}
	log.Println("server stopped cleanly")
}