java.lang.IllegalArgumentException: List has more than one element.
Ai apelat single() pe o listă care are mai mult de un element. single() garantează exact un element și aruncă excepție altfel. Dacă vrei primul, folosește first() / firstOrNull(); dacă poate fi zero sau unul, singleOrNull().
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
single() e o verificare și o citire în același timp: „lista trebuie să aibă exact un element; dă-mi-l”. Dacă lista e goală, aruncă NoSuchElementException: List is empty.. Dacă are două sau mai multe, aruncă IllegalArgumentException: List has more than one element.. Varianta cu condiție, single { it.cod == "X" }, aruncă Collection contains more than one matching element. dacă mai multe elemente îndeplinesc condiția.
Apare des când crezi că o căutare (după email, după cod) are un singur rezultat, dar datele au duplicate. Uneori excepția e chiar utilă: semnalează date greșite. Alteori ai vrut doar primul rezultat.
Alternativele: first() (primul, excepție doar dacă lista e goală), firstOrNull(), singleOrNull() (null dacă sunt zero sau mai multe).
De ce apare: cauzele frecvente
1single() când voiai primul element
fun main() {
val comenzi = listOf("C1", "C2")
println(comenzi.single())
}fun main() {
val comenzi = listOf("C1", "C2")
println(comenzi.first())
}first() nu cere ca lista să aibă un singur element.
2Date cu duplicate
data class User(val email: String, val nume: String)
fun main() {
val u = listOf(User("a@x.ro", "Ana"), User("a@x.ro", "Ana P."))
println(u.single { it.email == "a@x.ro" }.nume)
}data class User(val email: String, val nume: String)
fun main() {
val u = listOf(User("a@x.ro", "Ana"), User("a@x.ro", "Ana P."))
val gasit = u.singleOrNull { it.email == "a@x.ro" }
println(gasit?.nume ?: "email duplicat sau inexistent")
}singleOrNull întoarce null când nu există exact un rezultat, iar tu decizi ce afișezi.
Repară eroarea, direct în pagină
Programul de mai jos afișează produsul promovat al zilei, dar azi sunt două produse marcate ca promoție și programul se oprește cu IllegalArgumentException: List has more than one element.. Repară-l ca să afișeze primul produs în promoție: Promotia zilei: casti.
data class Produs(val nume: String, val promo: Boolean)
fun main() {
val produse = listOf(Produs("mouse", false), Produs("casti", true), Produs("cablu", true))
val promo = produse.filter { it.promo }.single()
println("Promotia zilei: ${promo.nume}")
}Promotia zilei: casti
Indiciu
Ai nevoie de primul element care îndeplinește condiția, nu de singurul: first { } sau firstOrNull { }.
Reparația
data class Produs(val nume: String, val promo: Boolean)
fun main() {
val produse = listOf(Produs("mouse", false), Produs("casti", true), Produs("cablu", true))
val promo = produse.first { it.promo }
println("Promotia zilei: ${promo.nume}")
}De ce merge
filter { it.promo } dă o listă cu două produse, iar single() cere exact unul, deci aruncă excepția. Regula afacerii era „primul produs în promoție”, adică first { it.promo }, care se oprește la primul element potrivit. Dacă ar putea să nu existe niciunul, firstOrNull { } cu ?: ar fi varianta sigură.
Alte forme ale mesajului
Exception in thread "main" java.lang.IllegalArgumentException: List has more than one element.java.lang.IllegalArgumentException: Collection contains more than one matching element.java.lang.IllegalArgumentException: Array has more than one element.java.lang.IllegalArgumentException: Char sequence has more than one element.
Cum o eviți pe viitor
Folosește single() doar când „exact unul” e o regulă a datelor și vrei să afli imediat dacă e încălcată. Pentru căutări obișnuite, firstOrNull { } sau find { }. Dacă un câmp trebuie să fie unic (email, cod produs), impune unicitatea la salvare (de exemplu cu un Map după cheie sau o constrângere în baza de date), nu doar la citire.
Întrebări frecvente
De ce e IllegalArgumentException și nu NoSuchElementException?
Pentru că elementul există, dar nu e unic: argumentul (lista) nu respectă condiția funcției. NoSuchElementException e rezervat cazului în care nu există niciun element.
Ce diferență e între find și firstOrNull?
Niciuna: find { } e un alias pentru firstOrNull { }.
Erori înrudite
java.util.NoSuchElementException: List is empty. Ai apelat first(), last(), max() sau o funcție asemănătoare pe o listă goală. Aceste funcții cer cel puțin un element. Folosește variantele OrNull (firstOrNull(), maxOrNull()) și tratează null, sau verifică înainte isNotEmpty(). java.util.NoSuchElementException: Collection contains no element matching the predicate. Ai folosit first { condiție } (sau last, single) și niciun element nu îndeplinește condiția. Folosește firstOrNull { } sau find { }, care întorc null când nu găsesc nimic, și tratează rezultatul cu ?: sau if. java.lang.IllegalArgumentException: Failed requirement. 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. Î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.
