Как ты можешь реализовать graceful shutdown для Go HTTP сервера, чтобы существующие запросы завершились, а сервер перестал принимать новые подключения?

Question

Accepted Answer

## Обзор

Чтобы реализовать **graceful shutdown** Go HTTP сервера, используй метод `http.Server.Shutdown()` вместе с обработкой сигналов. Это позволяет серверу перестать принимать новые соединения, но при этом корректно завершить уже существующие запросы.

## Основные компоненты

Реализация требует три главных элемента:

- Создай экземпляр `http.Server`
- Слушай **сигналы прерывания** с помощью `signal.Notify()`
- Вызови `Shutdown()` с контекстом, когда пришёл сигнал

## Пример реализации

```go
srv := &http.Server{Addr: ":8080"}

// Запусти сервер в горутине
go func() {
    if err := srv.ListenAndServe(); err != nil && err != http.ErrServerClosed {
        log.Fatalf("Server error: %v", err)
    }
}()

// Слушай interrupt сигналы (SIGINT, SIGTERM)
c := make(chan os.Signal, 1)
signal.Notify(c, os.Interrupt, syscall.SIGTERM)

// Жди, пока придёт сигнал
<-c

// Gracefully shutdown с timeout
ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second)
defer cancel()
srv.Shutdown(ctx)
```

## Лучшие практики

- Используй **контекст с таймаутом** (обычно 30 секунд), чтобы не ждать бесконечно
- Обрабатывай оба сигнала `SIGINT` и `SIGTERM` для более широкой совместимости
- Проверяй ошибку `http.ErrServerClosed`, чтобы отличить graceful shutdown от настоящих ошибок
- Давай активным запросам завершиться перед тем, как форсировать остановку
- Логируй события shutdown для прозрачности происходящего в продакшене

Этот подход гарантирует zero downtime во время деплоев и предотвращает резкие разрывы соединений с клиентами.

Как ты можешь реализовать graceful shutdown для Go HTTP сервера, чтобы существующие запросы завершились, а сервер перестал принимать новые подключения?

Ответ

Обзор

Основные компоненты

Пример реализации

Лучшие практики

Проверочные вопросы

Помогите улучшить этот вопрос

Обсуждение