Go: context, таймауты и отмена запросов к базе

· 2 мин чтения · gobackend

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()
	// ...
}

Несколько правил, к которым я пришёл:

Как проверить, что отмена работает

Самый простой тест — запрос, который заведомо выполняется долго, и клиент с коротким таймаутом:

curl -m 2 "http://localhost:8080/report?from=2020-01-01"

После обрыва в логах PostgreSQL должно появиться canceling statement due to user request. Если его нет — где-то по дороге контекст потерялся. Чаще всего виновата старая обёртка, которая вызывает db.Query вместо db.QueryContext.