Go: context, таймауты и отмена запросов к базе
Context в Go часто воспринимают как обязательный первый аргумент, который «надо куда-то передать». Но если передавать его до конца, он экономит ресурсы: когда клиент ушёл, сервер перестаёт делать бесполезную работу.
Таймауты на уровне сервера
Начинать стоит с http.Server. Значения по умолчанию — нули, то есть никаких ограничений:
srv := &http.Server{
Addr: ":8080",
Handler: mux,
ReadHeaderTimeout: 5 * time.Second,
ReadTimeout: 15 * time.Second,
WriteTimeout: 30 * time.Second,
IdleTimeout: 60 * time.Second,
}
ReadHeaderTimeout особенно важен: без него медленный клиент может держать соединение сколько угодно, присылая заголовки по байту.
Контекст запроса
У каждого входящего запроса есть контекст — r.Context(). Он отменяется, когда клиент закрывает соединение. Если передать его дальше, в базу, долгий запрос прервётся вместе с ним:
func (h *Handler) Report(w http.ResponseWriter, r *http.Request) {
ctx, cancel := context.WithTimeout(r.Context(), 10*time.Second)
defer cancel()
rows, err := h.db.QueryContext(ctx, reportSQL, r.URL.Query().Get("from"))
if err != nil {
switch {
case errors.Is(err, context.DeadlineExceeded):
http.Error(w, "report is taking too long", http.StatusGatewayTimeout)
case errors.Is(err, context.Canceled):
// клиент ушёл, отвечать некому
default:
http.Error(w, "internal error", http.StatusInternalServerError)
}
return
}
defer rows.Close()
// ...
}
Несколько правил, к которым я пришёл:
defer cancel()— всегда и сразу послеWithTimeout. Иначе таймер живёт до срабатывания, аgo vetоб этом предупредит.- Контекст не хранят в структурах — его передают первым аргументом.
- Фоновой задаче, которая должна пережить запрос, нужен свой контекст. С Go 1.21 удобно использовать
context.WithoutCancel(ctx): значения сохраняются, а отмена родителя на задачу не влияет.
Как проверить, что отмена работает
Самый простой тест — запрос, который заведомо выполняется долго, и клиент с коротким таймаутом:
curl -m 2 "http://localhost:8080/report?from=2020-01-01"
После обрыва в логах PostgreSQL должно появиться canceling statement due to user request. Если его нет — где-то по дороге контекст потерялся. Чаще всего виновата старая обёртка, которая вызывает db.Query вместо db.QueryContext.