Go 如何优雅地关闭 HTTP 服务？

Question

Go 如何优雅地关闭 HTTP 服务？

仓乃文 · Accepted Answer

优雅关闭（Graceful Shutdown）确保 HTTP 服务在收到终止信号后，不再接受新请求，等待现有请求处理完毕再退出。

完整实现：
```go
package main

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

func main() {
    mux := http.NewServeMux()
    mux.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
        time.Sleep(3 * time.Second)  // 模拟耗时请求
        w.Write([]byte("OK"))
    })

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

// 在 goroutine 中启动服务
    go func() {
        if err := srv.ListenAndServe(); err != http.ErrServerClosed {
            log.Fatalf("服务启动失败: %v", err)
        }
    }()

// 监听系统信号
    quit := make(chan os.Signal, 1)
    signal.Notify(quit, syscall.SIGINT, syscall.SIGTERM)
    <-quit  // 阻塞等待信号

log.Println("正在关闭服务...")
    ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
    defer cancel()

if err := srv.Shutdown(ctx); err != nil {
        log.Fatalf("服务关闭异常: %v", err)
    }
    log.Println("服务已安全关闭")
}
```

补充说明：
- Shutdown 先关闭所有监听器，再等待活跃连接处理完毕
- context.WithTimeout 设置关闭超时，防止无限等待
- signal.Notify 监听 SIGINT（Ctrl+C）和 SIGTERM（kill）
- 生产环境建议配合健康检查和就绪探针使用