Capture erros de rede e análise
Converta exceções do Ktor e do serializador em resultados
Capture erros de rede e análise é uma aula grátis de Kotlin Multiplatform Academy no CoddyKit. Esta é a aula 2 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Kotlin Multiplatform Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Kotlin Multiplatform Academy inclui 4 aulas no total.
Partes desta aula ainda não foram traduzidas e aparecem em inglês.
Where Errors Begin
Most failures appear at two spots: the network call and the JSON parse. Catching them here keeps the rest of your shared code clean and calm.
Wrap the Risky Call
Put the Ktor request and the decode inside a single try block. One guarded spot is easier to reason about than scattered checks.
try {
val user = client.get(url).body<User>()
} catch (e: Exception) { }Catch Network Failures
A dropped connection throws an IOException. Catch it and turn it into a clear Failure your UI can present as a connectivity problem.
catch (e: IOException) {
Failure("No connection")
}Catch Parsing Failures
When JSON does not match your model, kotlinx.serialization throws a SerializationException. Catch it separately so you know data, not the network, was bad.
catch (e: SerializationException) {
Failure("Bad data")
}Order Your catch Blocks
List the specific exceptions first and a broad Exception last. Kotlin matches top to bottom, so narrow types must come before the catch-all.
Return, Do Not Rethrow
Inside each catch, build a Failure and return it. Rethrowing would just push the crash up to the apps you are trying to protect.
Keep It in commonMain
This guarding belongs in shared code, right around the call. Both Android and iOS then receive the same safe Result with no extra work.
Inspect Ktor Status Codes
A reachable server can still answer 404 or 500. Check the response status and map non-2xx codes to a Failure too.
if (!resp.status.isSuccess())
return Failure("Server error")Avoid Swallowing Silently
Never leave an empty catch. Log the cause before returning Failure so you can still debug what really happened on a device.
runCatching as a Shortcut
Kotlin offers runCatching to wrap a block into a Result-like value, a tidy alternative when you do not need custom catch logic.
val r = runCatching { fetch() }One Funnel, Two Sources
Network and parsing errors now flow through one funnel into your Failure type, so callers handle both with the same simple branch.
Quick Check
Think about how kotlinx.serialization signals trouble.
Recap
You wrapped the call in try, caught IOException and SerializationException separately, mapped bad status codes, and returned tidy Failures from shared code. 🛡️
Perguntas Frequentes
A aula “Capture erros de rede e análise” é grátis?
Sim — o texto completo de “Capture erros de rede e análise” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Kotlin Multiplatform Academy, atualize para CoddyKit PRO. O curso de Kotlin Multiplatform Academy inclui 4 aulas no total.
O que vou aprender em “Capture erros de rede e análise”?
Converta exceções do Ktor e do serializador em resultados Você pratica Kotlin Multiplatform Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar Kotlin Multiplatform Academy?
Nenhuma experiência prévia é necessária. Kotlin Multiplatform Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 2 de 4.
Quanto tempo leva a aula “Capture erros de rede e análise”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de Kotlin Multiplatform Academy?
Sim. Cada aula de Kotlin Multiplatform Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Um tipo de resultado selado
- Capture erros de rede e análise
- Mapeie erros para mensagens da interface
- Novas tentativas e alternativas offline