...
Eroare Java · Colecții și Stream API

java.lang.UnsupportedOperationException

Pe scurt

Încerci să modifici (add, remove, set, put) o colecție imutabilă, creată cu List.of, Set.of, Map.of, Arrays.asList sau stream().toList(). Fă o copie modificabilă: new ArrayList<>(List.of(...)).

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

Ce înseamnă

UnsupportedOperationException înseamnă că obiectul are metoda pe care o apelezi (pentru că implementează interfața List), dar nu o suportă. Cel mai des apare la colecțiile imutabile:

  • List.of(...), Set.of(...), Map.of(...): nu permit nicio modificare;
  • stream().toList() și Collectors.toUnmodifiableList(): listă imutabilă;
  • Collections.unmodifiableList(lista): o vedere doar pentru citire;
  • Arrays.asList(...): permite set, dar nu add sau remove (dimensiunea e fixă).

Mesajul de obicei nu are text după numele excepției. Stiva de apeluri te ajută: vei vedea ImmutableCollections.uoe sau AbstractList.add, apoi linia din codul tău.

Reparația: dacă ai nevoie să modifici colecția, creeaz-o ca ArrayList, HashSet sau HashMap, de exemplu new ArrayList<>(List.of("a", "b")).

De ce apare: cauzele frecvente

1add pe List.of

Greșit
JAVA
List<String> cos = List.of("paine", "lapte");
cos.add("oua");
Corect
JAVA
List<String> cos = new ArrayList<>(List.of("paine", "lapte"));
cos.add("oua");

List.of creează o listă imutabilă. Copia într-un ArrayList se poate modifica.

2remove pe Arrays.asList

Greșit
JAVA
List<Integer> v = Arrays.asList(1, 2, 3);
v.remove(0);
Corect
JAVA
List<Integer> v = new ArrayList<>(Arrays.asList(1, 2, 3));
v.remove(0);

Arrays.asList e legată de un tablou cu dimensiune fixă: poți schimba elemente, dar nu poți adăuga sau șterge.

3Modificarea rezultatului lui toList()

Greșit
JAVA
List<String> scumpe = produse.stream().filter(p -> p.length() > 3).toList();
scumpe.add("extra");
Corect
JAVA
List<String> scumpe = new ArrayList<>(produse.stream().filter(p -> p.length() > 3).toList());
scumpe.add("extra");

Stream.toList() întoarce o listă imutabilă.

Repară tu

Repară eroarea, direct în pagină

Programul pornește de la o listă inițială de produse și adaugă unul nou, dar se oprește cu UnsupportedOperationException. Repară crearea listei, ca programul să afișeze Cos: [paine, lapte, oua].

Codul care dă eroarea
JAVA
import java.util.*;

public class Main {
    public static void main(String[] args) {
        List<String> cos = List.of("paine", "lapte");
        cos.add("oua");
        System.out.println("Cos: " + cos);
    }
}
După reparație, programul afișează
Cos: [paine, lapte, oua]
Indiciu

Lista creată cu List.of nu poate fi modificată; fă din ea un ArrayList.

Alte forme ale mesajului

  • java.lang.UnsupportedOperationException at java.base/java.util.ImmutableCollections.uoe(ImmutableCollections.java)
  • java.lang.UnsupportedOperationException at java.base/java.util.AbstractList.add(AbstractList.java)
  • java.lang.UnsupportedOperationException: remove

Cum o eviți pe viitor

  • Folosește List.of pentru date fixe (constante, liste de test) și new ArrayList<>() pentru date care se schimbă.
  • Când primești o listă de la altă metodă și vrei să o modifici, fă o copie: new ArrayList<>(lista).
  • Ține minte că stream().toList() e imutabilă, iar collect(Collectors.toList()) dă de obicei un ArrayList (fără garanție).
  • Colecțiile imutabile sunt bune: le poți da altor metode fără grija că vor fi modificate.

Întrebări frecvente

De ce compilatorul nu m-a oprit?

List.of întoarce tipul List, care are metoda add. Faptul că implementarea nu o suportă se vede doar la rulare.

List.of acceptă null?

Nu. List.of("a", null) aruncă NullPointerException chiar la creare.

Erori înrudite

← Toate erorile Java

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ță Java de la zero, cu exerciții la fiecare lecție

Curs Java: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.