...
Eroare Kotlin · Erori de sintaxă

Expecting a top level declaration

Pe scurt

Ai scris o instrucțiune (un apel ca println(...), o atribuire, un for) direct în fișier, în afara oricărei funcții. În Kotlin, la nivelul fișierului sunt permise doar declarații: fun, val, var, class, object. Mută instrucțiunea în main().

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

Ce înseamnă

O declarație de nivel superior (top level declaration) este ce poate sta direct în fișier: fun, val, var, class, object, interface, import, package. Instrucțiunile care fac ceva (apeluri, bucle, atribuiri) trebuie să stea într-o funcție.

Când compilatorul găsește, de exemplu, println("x") direct în fișier, raportează Expecting a top level declaration de mai multe ori pe aceeași linie (câte o dată pentru fiecare bucată pe care n-o înțelege). Prima apariție e cea care contează.

Cea mai frecventă cauză este o acoladă } în plus care închide main prea devreme: restul codului ajunge „afară”, iar fiecare linie de după dă această eroare. Altă cauză: cod copiat din exemple sau din Kotlin script (.kts), unde instrucțiunile pot sta direct în fișier.

De ce apare: cauzele frecvente

1Apel direct în fișier

Greșit
KOTLIN
println("Start")

fun main() {
    println("Program")
}
Corect
KOTLIN
fun main() {
    println("Start")
    println("Program")
}

Codul care se execută trebuie să fie într-o funcție. Programul pornește din main, deci acolo pui apelurile.

2O acoladă în plus închide main prea devreme

Greșit
KOTLIN
fun main() {
    if (true) {
        println("a")
    }}
    println("b")
}
Corect
KOTLIN
fun main() {
    if (true) {
        println("a")
    }
    println("b")
}

A doua } închide main, iar println("b") ajunge în afara funcției. Cu acoladele echilibrate instrucțiunea rămâne în main.

3Atribuire la nivelul fișierului

Greșit
KOTLIN
var contor = 0
contor = 5

fun main() {
    println(contor)
}
Corect
KOTLIN
var contor = 5

fun main() {
    println(contor)
}

Declarația var contor = 0 e permisă în fișier, dar atribuirea contor = 5 e o instrucțiune. Dă valoarea direct la declarare sau fă atribuirea în main.

Repară tu

Repară eroarea, direct în pagină

Programul de mai jos dă eroarea Expecting a top level declaration, pentru că mesajul de bun venit este afișat în afara oricărei funcții. Repară codul ca să afișeze, în ordine: Bun venit la magazin! și apoi Produse in cos: 3.

Codul care dă eroarea
KOTLIN
println("Bun venit la magazin!")

fun main() {
    val produse = listOf("paine", "lapte", "oua")
    println("Produse in cos: ${produse.size}")
}
După reparație, programul afișează
Bun venit la magazin!
Produse in cos: 3
Indiciu

Mută apelul println în interiorul lui main, înaintea celuilalt.

Alte forme ale mesajului

  • error: syntax error: Expecting a top level declaration.

Cum o eviți pe viitor

Ține minte regula: în fișier pui doar declarații, iar tot ce se execută stă în main sau în alte funcții. Folosește formatarea automată ca să vezi imediat dacă o acoladă închide main prea devreme. Când copiezi exemple din documentație (care uneori sunt scripturi .kts), lipește-le în interiorul lui main.

Întrebări frecvente

De ce primesc aceeași eroare de 5-6 ori pe aceeași linie?

Compilatorul încearcă să interpreteze fiecare bucată de pe linie (numele funcției, paranteza, stringul) ca o declarație și raportează pentru fiecare. E o singură greșeală: mută linia în main.

Pot avea variabile globale în Kotlin?

Da: val și var la nivelul fișierului sunt declarații permise, de exemplu val TVA = 0.19. Doar atribuirile și apelurile ulterioare trebuie să fie în funcții.

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.