...
Eroare Kotlin · Colecții și indecși

java.lang.IllegalArgumentException: List has more than one element.

Pe scurt

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

Greșit
KOTLIN
fun main() {
    val comenzi = listOf("C1", "C2")
    println(comenzi.single())
}
Corect
KOTLIN
fun main() {
    val comenzi = listOf("C1", "C2")
    println(comenzi.first())
}

first() nu cere ca lista să aibă un singur element.

2Date cu duplicate

Greșit
KOTLIN
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)
}
Corect
KOTLIN
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ă tu

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.

Codul care dă eroarea
KOTLIN
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}")
}
După reparație, programul afișează
Promotia zilei: casti
Indiciu

Ai nevoie de primul element care îndeplinește condiția, nu de singurul: first { } sau firstOrNull { }.

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

← 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.