Отмена в asyncio: освобождайте ресурсы, не поглощая CancelledError

Что это такое

Документация Python по asyncio рекомендует try/finally для освобождения ресурсов и, как правило, дальнейшее распространение CancelledError после явной обработки. Она предупреждает, что TaskGroup и механизмы тайм-аутов внутренне используют отмену и могут работать неправильно, если корутина её поглощает. Поэтому отмена — часть контракта задачи, а не просто ещё одна ошибка, которую можно превратить в обычный результат. Python asyncio tasks

Почему это важно

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

Как применять

• Найдите все обработчики исключений вокруг операций, завершения которых ожидает корутина, и определите, какой обрабатывает отмену. Запишите, распространяет ли корутина её дальше, преобразует или намеренно подавляет.
• Поместите освобождение ресурсов в блок finally или подходящий асинхронный менеджер контекста. Ограничьте очистку её задачей и определите, что произойдёт при сбое или отмене самой очистки.
• Если явно перехватываете CancelledError ради дополнительной работы, обычно возбуждайте его повторно после неё. Считайте подавление осознанным проектным решением, требующим документированного протокола на уровне владельца.
• Предложите сценарии с отменой до получения ресурса, во время операции, завершения которой ожидает корутина, и после частичного прогресса. Проверяйте состояние ресурсов и конечный исход задачи, а не только появление строки журнала.
• Выполните корутину внутри её реального TaskGroup или контекста тайм-аута, чтобы видеть взаимодействия с родительской областью.

Подводные камни

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