Kotlin Coroutines

Overview

Kotlin coroutines are built on structured concurrency: every coroutine runs within a scope, and cancellation/errors propagate through the parent-child hierarchy automatically.

Core principle: Suspend functions must always be main-safe. The function doing blocking work owns the withContext call — callers should never need to switch dispatchers.

Diagnosing Coroutine Issues

When reviewing or debugging coroutine code, triage the symptom first: