Kotlin 强调父子关系：父协程取消会级联子协程。然而在实际业务中，有时我们只想停掉某个耗时子任务，而不希望它把兄弟节点一起拉下水。这种“一刀切”的行为在复杂 DAG 中极易产生不可预期的副作用。

suspend fun readFile: ByteArray = suspendCancellableCoroutine { cont ->
    val stream = FileInputStream
    cont.invokeOnCancellation {
        // 当外部调用 cancel 时执行
        stream.close
        Log.d
    }
    try {
        val data = stream.readBytes
        cont.resume
    } catch  {
        cont.resumeWithException
    }
}

val job = launch {
    for  {
        // 每处理完一批数据就检查一次
        if  break
        heavyCompute
        // 或者geng简洁
        ensureActive
    }
}
...
job.cancel

*技巧*：将「检查」封装成 函数，这样即使忘记也不会遗漏：

inline fun CoroutineScope.checkCancellation {
    if  throw CancellationException
}
...
while  {
   checkCancellation
   // 真正业务代码
}

try {
    downloadLargeFile
} catch  {
    Log.w
    throw e      // 必须重新抛出，让父协程感知
} finally {
    withContext {
        cache.flush
        socket.close
        Log.i
    }
}

Kotlin 的 cancel 方法允许传入自定义异常，这正是给业务留下“标签”的好机会：

class NetworkTimeoutException : CancellationException
...
job.cancel)

kotlin
catch  { /* 特殊上报 */ }
catch  { /* 通用处理 */ }

"cancel 后马上 await": Ru果先调用了 .cancel, 再去 .await, 会抛出 JobCancellationException​，但hen多人误以为 await 本身Neng触发 cancel。因此Zui好先等待 join, 再决定是否继续.