0Pricing
Go Academy · Урок

WithCancel и WithTimeout

Создание отменяемых контекстов и контекстов с ограничением времени

«WithCancel и WithTimeout» — бесплатный урок Go Academy на CoddyKit. Это урок 2 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения Go Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс Go Academy содержит 4 уроков всего.

context.WithCancel

WithCancel создаёт производный контекст с функцией отмены. Вызов cancel закрывает канал Done производного контекста и всех его потомков.

ctx, cancel := context.WithCancel(parent)
defer cancel() // always call to release resources
go doWork(ctx)

Всегда откладывайте вызов cancel

Если не вызвать функцию отмены, это приводит к утечке горутины, отслеживающей родительский контекст. Всегда откладывайте вызов cancel сразу после создания отменяемого контекста.

context.WithTimeout

WithTimeout создаёт контекст, который автоматически отменяется через указанный промежуток времени. Это удобная оболочка вокруг WithDeadline.

ctx, cancel := context.WithTimeout(parent, 5*time.Second)
defer cancel()
if err := db.QueryContext(ctx, query); err != nil {
    // err may be context.DeadlineExceeded
}

Проверка Err()

После закрытия Done ctx.Err() возвращает причину: context.Canceled (явная отмена) или context.DeadlineExceeded (тайм-аут).

if err := ctx.Err(); errors.Is(err, context.DeadlineExceeded) {
    log.Println("timeout")
}

Отмена из другой горутины

Функцию отмены безопасно вызывать из любой горутины и одновременно из нескольких горутин. Действует только первый вызов.

ctx, cancel := context.WithCancel(context.Background())
go func() {
    if detectError() { cancel() }
}()

Тайм-аут HTTP-запроса

Установите тайм-аут для каждого запроса с помощью WithTimeout, применив его к контексту входящего запроса:

func handler(w http.ResponseWriter, r *http.Request) {
    ctx, cancel := context.WithTimeout(r.Context(), 2*time.Second)
    defer cancel()
    result, err := service.Call(ctx)
    // ...
}

Каскадная отмена

Если родительский контекст отменён, все производные контексты (дочерние, внучатые) автоматически отменяются, останавливая все горутины в дереве вызовов.

Context в тестах

Используйте context.Background() или context.WithTimeout в тестах, чтобы ограничить по времени работу горутин, запущенных тестами.

ctx, cancel := context.WithTimeout(context.Background(), 3*time.Second)
defer cancel()
testResult := runTest(ctx)

Передача контекста через библиотеки

Всегда передавайте полученный контекст в исходящие вызовы (запросы к БД, HTTP-вызовы, RPC-вызовы). Не отбрасывайте и не заменяйте его без особой причины, например необходимости сбросить крайний срок.

Создание контекста для фоновой задачи

Для фоновых задач, не связанных с запросом, используйте context.Background() как корневой контекст и добавьте WithCancel, чтобы задачу можно было корректно остановить.

select с Done

Всегда обрабатывайте ctx.Done() в select вместе с рабочим каналом, чтобы не заблокироваться, если контекст будет отменён до завершения работы.

select {
case result := <-workCh:
    return result, nil
case <-ctx.Done():
    return nil, ctx.Err()
}

Быстрая проверка

В чём разница между context.WithCancel и context.WithTimeout?

Повторение: WithCancel и WithTimeout

Основные моменты:

  • Всегда откладывайте вызов cancel() сразу после создания контекста
  • WithTimeout автоматически отменяется через заданный промежуток времени и возвращает DeadlineExceeded
  • ctx.Err() различает Canceled и DeadlineExceeded
  • Отмена распространяется на все производные контексты

Часто задаваемые вопросы

Урок «WithCancel и WithTimeout» бесплатный?

Да — полный текст урока «WithCancel и WithTimeout» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс Go Academy, подпишись на CoddyKit PRO. Курс Go Academy содержит 4 уроков всего.

Чему я научусь в уроке «WithCancel и WithTimeout»?

Создание отменяемых контекстов и контекстов с ограничением времени Ты практикуешь Go Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.

Нужен ли мне опыт, чтобы начать Go Academy?

Предыдущий опыт не требуется. Go Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 2 из 4.

Сколько времени занимает урок «WithCancel и WithTimeout»?

Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.

Можно ли писать и запускать код в этом уроке Go Academy?

Да. Каждый урок Go Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.

Все уроки этого курса

  1. Зачем нужен context.Context
  2. WithCancel и WithTimeout
  3. WithDeadline и WithValue
  4. Контекст в HTTP- и вызовах к базе данных
← Назад к Go Academy