...
Eroare Kotlin · Corutine

Suspend function 'suspend fun delay(timeMillis: Long): Unit' can only be called from a coroutine or another suspend function

Pe scurt

Apelezi o funcție suspend (delay, o funcție proprie marcată suspend) dintr-o funcție obișnuită. Funcțiile suspend pot fi apelate doar din corutine sau din alte funcții suspend. Marchează și funcția apelantă cu suspend, sau pornește o corutină, de exemplu cu runBlocking { } în main.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

O funcție suspend se poate suspenda: poate aștepta (după delay, după un răspuns de la server) fără să blocheze firul de execuție. Ca să poată fi suspendată și reluată, are nevoie de contextul unei corutine. De aceea compilatorul o lasă să fie apelată doar din:

  • alte funcții suspend;
  • blocurile de corutine: runBlocking { }, launch { }, async { }, withContext { }, coroutineScope { }.

În Kotlin 1.x mesajul era Suspend function 'delay' should be called only from a coroutine or another suspend function. În Kotlin 2 apare semnătura completă a funcției.

Eroarea apare des în trei situații: în main fără runBlocking, într-o funcție proprie care apelează delay dar nu e marcată suspend, sau într-o lambda obișnuită (de exemplu în forEach sau într-un callback), care nu e funcție suspend. În Android, din UI pornești corutinele cu lifecycleScope.launch sau viewModelScope.launch.

De ce apare: cauzele frecvente

1delay direct în main

Greșit
KOTLIN
import kotlinx.coroutines.*

fun main() {
    delay(100)
    println("Gata")
}
Corect
KOTLIN
import kotlinx.coroutines.*

fun main() = runBlocking {
    delay(100)
    println("Gata")
}

runBlocking pornește o corutină în care poți apela funcții suspend.

2Funcție proprie nemarcată suspend

Greșit
KOTLIN
import kotlinx.coroutines.*

fun incarcaDate(): String {
    delay(100)
    return "date"
}
Corect
KOTLIN
import kotlinx.coroutines.*

suspend fun incarcaDate(): String {
    delay(100)
    return "date"
}

O funcție care apelează funcții suspend trebuie să fie și ea suspend. Apoi o apelezi dintr-o corutină.

Repară tu

Repară eroarea, direct în pagină

Programul de mai jos simulează încărcarea unui profil, dar dă eroarea Suspend function ... can only be called from a coroutine or another suspend function. Repară funcția incarcaProfil ca programul să afișeze Se incarca... și apoi Profil: Ana.

Codul care dă eroarea
KOTLIN
import kotlinx.coroutines.*

fun incarcaProfil(): String {
    delay(50)
    return "Ana"
}

fun main() = runBlocking {
    println("Se incarca...")
    println("Profil: ${incarcaProfil()}")
}
După reparație, programul afișează
Se incarca...
Profil: Ana
Indiciu

O funcție care apelează delay trebuie marcată suspend; main pornește deja o corutină cu runBlocking.

Alte forme ale mesajului

  • Suspend function 'delay' should be called only from a coroutine or another suspend function
  • error: suspend function 'suspend fun delay(timeMillis: Long): Unit' can only be called from a coroutine or another suspend function.
  • Suspend function 'suspend fun incarcaDate(): String' can only be called from a coroutine or another suspend function

Cum o eviți pe viitor

Ține minte lanțul: funcțiile care așteaptă (rețea, bază de date, delay) sunt suspend, iar ele se apelează din alte suspend sau dintr-un bloc de corutină. Pornește corutinele într-un singur loc (în main cu runBlocking, în Android cu viewModelScope / lifecycleScope), iar restul codului îl scrii ca funcții suspend obișnuite. Nu pune runBlocking în fiecare funcție: în aplicații blochează firul principal.

Întrebări frecvente

Primesc eroarea în interiorul lui forEach dintr-o funcție suspend. De ce?

forEach e inline, deci acolo merge. Eroarea apare la lambde care nu sunt inline (callback-uri, Thread {}, setOnClickListener {}): ele nu sunt corutine. Pornește o corutină în interiorul lor sau mută apelul în afara lor.

runBlocking e soluția bună în Android?

Nu: runBlocking blochează firul pe care rulează, deci pe UI ar îngheța aplicația. Folosește viewModelScope.launch { } sau lifecycleScope.launch { }. runBlocking e potrivit în main și în teste.

Erori înrudite

← Toate erorile Kotlin

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Kotlin de la zero, cu exerciții la fiecare lecție

Curs Kotlin (Android): lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.