Уходишь с экрана — в логах появляется:
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 делает корутину неотменяемой: система считает, что отмена обработана, и работа продолжается. Отсюда берутся утечки, которые потом ищут неделями.
Когда это всё-таки настоящая проблема
Сообщение безобидно, если появляется там, где отмена ожидаема: ушли с экрана, сменили запрос, отменили загрузку. Насторожиться стоит, если:
- оно появляется, когда ничего не отменяли;
- после него перестаёт работать то, что должно работать;
- оно приходит из корутины, которая обязана была доработать до конца.
Тогда дело не в логе, а в том, что чей-то скоуп умирает раньше времени.
Как устроена отмена и почему она кооперативная — в руководстве по корутинам.