JobCancellationException: Job was cancelled в логах — что это и надо ли чинить

Уходишь с экрана — в логах появляется:

kotlinx.coroutines.JobCancellationException: Job was cancelled

Приложение при этом работает нормально: ничего не падает, пользователь ничего не замечает. Но лог засоряется, и непонятно, баг это или нет.

Короткий ответ: это не ошибка. Это штатный сигнал о том, что корутину отменили. И в лог он попал не сам — его туда отправил ваш собственный код.

Почему отмена вообще сделана через исключение

Вопрос законный: отменили корутину — зачем бросать исключение?

Потому что корутину нужно не просто «выключить», а аккуратно свернуть. Она стоит посреди работы, у неё открыт курсор базы, недописан файл, захвачен ресурс. Всё это освобождается в блоках finally, а finally выполняется только если управление разматывает стек — то есть при исключении.

Поэтому отмена и устроена так: cancel() ставит флаг, а при первом же вызове отменяемой функции бросается CancellationException. Он проходит вверх, выполняя все finally по пути, и корутина заканчивается чисто.

Небольшое уточнение, которое экономит часы отладки: исключение возникает не в момент cancel() и не «при первой возможности», а при первом вызове функции, которая умеет отменяться. Если такой функции в коде нет, не возникнет вообще никогда.

Как оно попало в лог

Библиотека отменённые корутины не логирует. Значит, где-то в коде есть такое:

try {
    repository.load()
} catch (e: Exception) {     // сюда попадает и CancellationException
    Log.e(TAG, "ошибка загрузки", e)
}

Экран закрылся → viewModelScope отменился → работа прервалась CancellationException → общий catch его поймал и записал как ошибку.

Ищите по проекту catch (e: Exception), catch (e: Throwable) и runCatching { }.onFailure { log(it) } — виновник среди них.

Как починить

Пропускать отмену дальше, а логировать всё остальное:

try {
    repository.load()
} catch (e: CancellationException) {
    throw e                              // отмена идёт дальше по дереву
} catch (e: Exception) {
    Log.e(TAG, "ошибка загрузки", e)
}

Порядок важен: CancellationException должен стоять выше общего catch, иначе до него не дойдёт.

Если ловить приходится в одном месте на всё приложение, тот же приём пишется короче:

catch (e: Exception) {
    if (e is CancellationException) throw e
    Log.e(TAG, "ошибка", e)
}

Это не косметика. Проглоченный CancellationException делает корутину неотменяемой: система считает, что отмена обработана, и работа продолжается. Отсюда берутся утечки, которые потом ищут неделями.

Когда это всё-таки настоящая проблема

Сообщение безобидно, если появляется там, где отмена ожидаема: ушли с экрана, сменили запрос, отменили загрузку. Насторожиться стоит, если:

  • оно появляется, когда ничего не отменяли;
  • после него перестаёт работать то, что должно работать;
  • оно приходит из корутины, которая обязана была доработать до конца.

Тогда дело не в логе, а в том, что чей-то скоуп умирает раньше времени.

Как устроена отмена и почему она кооперативная — в руководстве по корутинам.