...
Eroare Kotlin · Excepții la rulare

java.lang.IllegalArgumentException: Failed requirement.

Pe scurt

O verificare require(...) din cod a primit false: o funcție a fost apelată cu un argument invalid (o sumă negativă, o listă goală). Repară apelul ca să trimită date valide sau tratează cazul înainte de apel. Pune un mesaj în require ca eroarea să spună ce e greșit.

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

Ce înseamnă

require(conditie) este felul în care o funcție își verifică argumentele. Dacă condiția e falsă, aruncă java.lang.IllegalArgumentException: Failed requirement.. Mesajul generic apare când require n-are mesaj propriu; cu require(suma > 0) { "Suma trebuie să fie pozitivă" } primești textul tău în locul lui.

Ruda lui, check(conditie), verifică starea obiectului (nu argumentele) și aruncă java.lang.IllegalStateException: Check failed.. requireNotNull(x) aruncă IllegalArgumentException: Required value was null., iar error("mesaj") aruncă direct IllegalStateException cu mesajul dat.

Excepția nu e o greșeală a lui require, ci un semnal: cineva a apelat funcția cu date pe care ea nu le acceptă. Stiva arată două linii utile: funcția cu require și locul de unde a fost apelată. Repari de obicei apelul, nu verificarea.

De ce apare: cauzele frecvente

1Apel cu o valoare invalidă

Greșit
KOTLIN
fun retrage(sold: Int, suma: Int): Int {
    require(suma > 0)
    return sold - suma
}

fun main() {
    println(retrage(100, -20))
}
Corect
KOTLIN
fun retrage(sold: Int, suma: Int): Int {
    require(suma > 0) { "Suma trebuie sa fie pozitiva: $suma" }
    return sold - suma
}

fun main() {
    println(retrage(100, 20))
}

Apelul trimite acum o sumă validă, iar mesajul din require ar explica problema dacă s-ar repeta.

2check pe o stare greșită

Greșit
KOTLIN
class Comanda {
    var platita = false
    fun livreaza() {
        check(platita)
        println("Livrata")
    }
}

fun main() {
    Comanda().livreaza()
}
Corect
KOTLIN
class Comanda {
    var platita = false
    fun livreaza() {
        check(platita) { "Comanda nu e platita" }
        println("Livrata")
    }
}

fun main() {
    val c = Comanda()
    c.platita = true
    c.livreaza()
}

check aruncă IllegalStateException: Check failed. dacă obiectul nu e în starea potrivită. Ordinea corectă a pașilor o rezolvă.

Repară tu

Repară eroarea, direct în pagină

Programul de mai jos aplică o reducere procentuală, dar se oprește cu IllegalArgumentException: Failed requirement., pentru că reducerea este scrisă ca fracție (0.15) în loc de procent. Repară apelul ca reducerea să fie 15%, iar programul să afișeze Pret final: 85.0.

Codul care dă eroarea
KOTLIN
fun aplicaReducere(pret: Double, procent: Double): Double {
    require(procent >= 1 && procent <= 100)
    return pret - pret * procent / 100
}

fun main() {
    println("Pret final: ${aplicaReducere(100.0, 0.15)}")
}
După reparație, programul afișează
Pret final: 85.0
Indiciu

Funcția cere un procent între 1 și 100; trimite 15, nu 0.15.

Alte forme ale mesajului

  • java.lang.IllegalStateException: Check failed.
  • java.lang.IllegalArgumentException: Required value was null.
  • Exception in thread "main" java.lang.IllegalArgumentException: Failed requirement.

Cum o eviți pe viitor

Scrie întotdeauna un mesaj în require și check, cu valoarea problematică: require(varsta >= 0) { "Varsta invalida: $varsta" }. Validează datele externe (input, fișiere) la intrare, înainte să ajungă la funcțiile care le verifică. Folosește require pentru argumente, check pentru starea obiectului și error() pentru cazuri care n-ar trebui să apară niciodată.

Întrebări frecvente

Ce diferență e între require și check?

require verifică argumentele primite și aruncă IllegalArgumentException. check verifică starea obiectului sau a programului și aruncă IllegalStateException. Ambele primesc un mesaj opțional în acolade.

E mai bine să prind excepția cu try/catch?

Doar acolo unde poți face ceva util (de exemplu să afișezi un mesaj utilizatorului). De obicei e mai bine să verifici datele înainte de apel, ca excepția să nu apară deloc.

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.