Опубликовано в Профессии

Context в Go: что происходит, когда запрос отменён

Настольный вентилятор стоит с лежащей рядом неподключённой вилкой провода перед отдельной розеткой.

Время чтения: 5 мин.

В Go отмена context передаёт сигнал о том, что работу по запросу следует прекратить. Она сама не завершает горутину, не откатывает запись и не заставляет произвольную функцию немедленно вернуться. Реакцию обеспечивают код приложения и используемые библиотеки. Поэтому разбираться с context лучше по одному запросу, у которого есть наблюдаемое начало, отмена и завершение.

Представим учебный сервис поиска документов. HTTP-обработчик обращается к хранилищу, затем собирает ответ. Пользователь закрывает страницу, пока выполняется запрос к базе. Нам нужно понять, какая часть работы прекратилась, какие ресурсы освободились и мог ли результат уже успеть сохраниться.

Рука придерживает первый из трёх соединённых синих вагончиков с сигнальными огнями.

Проследи контекст через весь вызов

Начни с контекста входящего HTTP-запроса и передай его дальше: в функцию поиска, затем в операцию хранилища. Если на одном из переходов создать новый независимый корневой контекст, сигнал от исходного запроса дальше не дойдёт. Вызовы будут выглядеть связанными в коде, но получат разное время жизни.

Документация пакета context описывает передачу deadline, отмены и значений, относящихся к запросу. Производный контекст наследует отмену родителя. При этом можно задать более короткий срок отдельной операции: он должен укладываться в оставшееся время исходного запроса.

Для упражнения нарисуй цепочку из трёх функций и рядом с каждой подпиши, какой контекст она принимает. Затем найди все вызовы, где контекст создаётся заново. Каждый такой переход требует объяснения. Иногда независимая задача действительно нужна, но это отдельное решение с собственным завершением и обработкой ошибок.

Раздели сигнал, ожидание и работу

Канал Done сообщает об отмене, а Err помогает узнать её причину после завершения контекста. Эти свойства полезны только там, где код их проверяет или вызывает операцию, которая умеет реагировать на контекст. Обычный цикл вычислений продолжит работать, если в нём нет предусмотренной точки выхода.

Проверь три разных случая: ожидание результата из канала, сетевой запрос и локальный цикл обработки большого списка. Для каждого укажи, что позволяет остановиться. В ожидании нескольких событий можно предусмотреть ветку отмены; для сетевого вызова используется API с контекстом; для цикла нужны разумно расположенные проверки.

Не проверяй контекст перед каждой простой строкой ради видимости контроля. Выбери границы достаточно крупных операций и объясни возможную задержку реакции. Если отдельная операция может надолго заблокироваться, проверка перед ней не решит проблему: понадобится поддержка отмены внутри самой операции или другая организация работы.

Срок операции не равен времени ответа клиенту

Deadline относится к работе, связанной с контекстом. Доставка HTTP-ответа, ограничения сервера и сетевые тайм-ауты имеют собственные условия. Полезно отдельно спросить: сколько времени разрешено всей операции, сколько отдельному запросу к базе и сколько сервер готов ждать чтения или записи соединения.

В учебном примере можно выделить две секунды поиску и меньшую часть этого времени внешней зависимости. Эти числа нужны для эксперимента, а не служат универсальными настройками production. Подбери их так, чтобы в тесте явно различались успешный путь и превышение срока.

У каждой созданной функции отмены должен быть понятный владелец. Вызывай её, когда соответствующая работа закончена, чтобы освободить связанные ресурсы раньше, если они больше не нужны. Не передавай ответственность нескольким случайным участникам. Когда владелец виден в одной функции, проверять завершение гораздо проще.

Проверь поведение настоящего драйвера

Для SQL в Go существуют операции с контекстом. Официальный материал об отмене операций базы показывает передачу контекста в запрос и ограничение времени. Но поддержку и фактическую реакцию выбранного драйвера всё равно нужно проверить в своей среде.

Подготовь контролируемую задержку на тестовой базе. Начни запрос, отмени родительский контекст, зафиксируй момент возврата функции и проверь состояние соединений. Повтори опыт со сроком производного контекста. Ожидаемый результат запиши до запуска, чтобы затем не подогнать объяснение под наблюдение.

Отдельно воспроизведи отмену во время изменения данных. Возврат ошибки ещё не говорит, что сервер базы ничего не сделал. Операция могла дойти до выполнения, а подтверждение потеряться. Для действия с последствиями нужно определить способ проверки итогового состояния и правила безопасного повтора. Один context не обеспечивает идемпотентность.

Рука поворачивает вентиль синего крана, из которого капает вода в ведро.

Не теряй горутины после ухода клиента

Допустим, обработчик запускает работника и ждёт ответ через небуферизованный канал. После отмены обработчик возвращается, а работник пытается отправить результат. Получателя больше нет, поэтому жизнь работника может оказаться длиннее жизни запроса.

Сформулируй правило завершения обоих участников. Работник должен иметь возможность закончить, даже если результат уже никому не нужен. При этом буфер в канале решает только отдельную ситуацию отправки; он не заменяет управление всеми остальными ожиданиями и ресурсами. Проверь также остановку внешних вызовов и закрытие строк результата базы.

Для HTTP важно читать контракт Request.Context в net/http. У входящего серверного запроса отмена связана, в частности, с закрытием клиентского соединения и завершением ServeHTTP. Не переноси эти условия автоматически на произвольные фоновые задачи, которые создаёт приложение.

Если после ухода клиента нужно продолжить полезную фоновую работу, сначала оформи её как самостоятельную задачу. Укажи владельца, предельное время, место хранения результата и способ повторного запуска. Простая замена исходного контекста на Background скрывает потерю связи, но не создаёт этих правил. Например, подготовку большого отчёта можно представить отдельной записью задания, статус которой затем запрашивает клиент. Это уже другой контракт API. Для короткого учебного поиска документов отдельное задание обычно не нужно: достаточно корректно завершить цепочку вызовов и показать, что следующий запрос обслуживается нормально.

Собери проверку без случайных пауз

Надёжный учебный тест сначала подтверждает, что зависимость действительно начала работу, затем вызывает отмену и наблюдает завершение. Если заменить первую часть фиксированной паузой, тест будет зависеть от скорости машины: иногда отмена произойдёт раньше нужного места.

Используй отдельный сигнал начала работы и ограниченное ожидание результата. Проверь, что после отмены работник возвращается, ресурсы доступны следующему запросу, а в журнале есть безопасный идентификатор операции и различимая причина завершения. Полные входные документы и токены для этого не нужны.

В результате у тебя должно появиться объяснение из трёх частей: откуда приходит отмена, кто её замечает и что остаётся после завершения. Если можешь показать все три части на реальном запросе и повторить эксперимент, context перестаёт быть обязательным аргументом, который просто передают через функции.

Укрепи знания по backend

Создай бесплатный аккаунт в LMS hitalent и посмотри теорию опубликованных курсов и открытые роадмапы по backend-подготовке. Следующий пробел проверь на своём сценарии отмены запроса.

Зарегистрироваться бесплатно