...
Eroare Kotlin · Variabile, val/var și nume

Only 'const val' can be used in constant expressions

Pe scurt

Ai pus un val obișnuit (sau o expresie calculată) ca argument al unei adnotări, unde Kotlin acceptă doar constante de compilare. Declară valoarea const val la nivel de fișier sau în object / companion object, ori scrie direct literalul.

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

Ce înseamnă

Argumentele adnotărilor (@Deprecated(...), @Suppress(...), @JvmName(...), adnotările din Spring, Room, Retrofit) se scriu în bytecode la compilare, deci trebuie cunoscute atunci. Kotlin acceptă doar literale ("text", 42), const val, alte adnotări, referințe la clase (X::class) și array-uri din acestea.

Un val obișnuit este calculat la rulare (chiar dacă în cod pare constant), așa că folosirea lui într-o adnotare dă Only 'const val' can be used in constant expressions. Dacă argumentul este un var sau o expresie care nu e constantă, mesajul este Annotation argument must be a compile-time constant.

const val se poate declara doar la nivel de fișier, într-un object sau companion object, și doar pentru tipuri primitive și String.

De ce apare: cauzele frecvente

1val obișnuit într-o adnotare

Greșit
KOTLIN
val MESAJ = "Foloseste totalNou()"

@Deprecated(MESAJ)
fun total() = 1
Corect
KOTLIN
const val MESAJ = "Foloseste totalNou()"

@Deprecated(MESAJ)
fun total() = 1

const val este înlocuit cu valoarea lui la compilare, deci poate apărea în adnotare; un val simplu nu.

2Constantă din object fără const

Greșit
KOTLIN
object Rute {
    val PRODUSE = "/api/produse"
}

@GetMapping(Rute.PRODUSE)
fun produse() = listOf<String>()
Corect
KOTLIN
object Rute {
    const val PRODUSE = "/api/produse"
}

@GetMapping(Rute.PRODUSE)
fun produse() = listOf<String>()

Rutele din Spring, numele de tabele din Room și căile din Retrofit sunt argumente de adnotare: constantele lor trebuie marcate const.

3var sau valoare calculată ca argument

Greșit
KOTLIN
var nivel = "unused"

@Suppress(nivel)
fun f() = 1
Corect
KOTLIN
@Suppress("unused")
fun f() = 1

Un var se poate schimba la rulare; aici mesajul este Annotation argument must be a compile-time constant. Scrie literalul sau un const val.

Repară tu

Repară eroarea, direct în pagină

Funcția veche pretVechi e marcată @Deprecated cu un mesaj păstrat în constanta MESAJ, dar programul nu compilează: Only 'const val' can be used in constant expressions. Repară declarația constantei (fără să scrii mesajul direct în adnotare) ca programul să afișeze Pret: 119.0.

Codul care dă eroarea
KOTLIN
val MESAJ = "Foloseste pretCuTva()"

@Deprecated(MESAJ)
fun pretVechi(p: Double) = p * 1.19

fun pretCuTva(p: Double) = p * 1.19

fun main() {
    println("Pret: ${pretCuTva(100.0)}")
}
După reparație, programul afișează
Pret: 119.0
Indiciu

Valorile folosite în adnotări trebuie să fie const val.

Alte forme ale mesajului

  • error: only 'const val' can be used in constant expressions.
  • Annotation argument must be a compile-time constant
  • error: annotation argument must be a compile-time constant.
  • An annotation argument must be a compile-time constant

Cum o eviți pe viitor

Ține constantele folosite în adnotări (rute, chei, nume de tabele) într-un object sau la nivel de fișier, marcate const val, cu nume în majuscule. Nu încerca să construiești argumentul la rulare (concatenări cu valori din config, System.getenv): adnotările se citesc la compilare. Dacă ai nevoie de o valoare dinamică, folosește mecanismul framework-ului (de exemplu ${...} din Spring), nu o variabilă Kotlin.

Întrebări frecvente

Pot face const val dintr-o listă sau dintr-un obiect?

Nu. const merge doar pentru String, numere, Char și Boolean, cu valori calculate la compilare. Pentru restul, mesajul este cel din Const 'val' initializer must be a constant value sau Const 'val' has type ....

Concatenarea a două const val este constantă?

Da: const val BASE = "/api" și const val PRODUSE = BASE + "/produse" sunt ambele constante de compilare și pot fi folosite în adnotări.

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.