java.lang.UnsupportedOperationException
Î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()șiCollectors.toUnmodifiableList(): listă imutabilă;Collections.unmodifiableList(lista): o vedere doar pentru citire;Arrays.asList(...): permiteset, dar nuaddsauremove(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
List<String> cos = List.of("paine", "lapte");
cos.add("oua");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
List<Integer> v = Arrays.asList(1, 2, 3);
v.remove(0);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()
List<String> scumpe = produse.stream().filter(p -> p.length() > 3).toList();
scumpe.add("extra");List<String> scumpe = new ArrayList<>(produse.stream().filter(p -> p.length() > 3).toList());
scumpe.add("extra");Stream.toList() întoarce o listă imutabilă.
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].
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);
}
}Cos: [paine, lapte, oua]
Indiciu
Lista creată cu List.of nu poate fi modificată; fă din ea un ArrayList.
Reparația
import java.util.*;
public class Main {
public static void main(String[] args) {
List<String> cos = new ArrayList<>(List.of("paine", "lapte"));
cos.add("oua");
System.out.println("Cos: " + cos);
}
}De ce merge
List.of creează o listă imutabilă: are metoda add, pentru că implementează List, dar orice modificare aruncă UnsupportedOperationException. new ArrayList<>(List.of(...)) copiază elementele într-o listă obișnuită, care poate crește, așa că add("oua") funcționează. Lista inițială rămâne imutabilă; noi lucrăm cu copia ei.
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.ofpentru date fixe (constante, liste de test) șinew 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ă, iarcollect(Collectors.toList())dă de obicei unArrayList(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
java.util.ConcurrentModificationException Ai modificat o colecție (add sau remove) în timp ce o parcurgeai cu for-each sau cu un iterator. Folosește lista.removeIf(...), iterator.remove() sau construiește o listă nouă cu elementele dorite. error: cannot assign a value to final variable TVA Încerci să schimbi o variabilă sau un câmp declarat final, care poate primi valoare o singură dată. Folosește o variabilă nouă pentru valoarea calculată sau scoate final dacă valoarea chiar trebuie să se schimbe. java.lang.IndexOutOfBoundsException: Index 3 out of bounds for length 3 Ai apelat get, set sau remove pe o listă cu un indice mai mare sau egal cu size(). Indicii unei liste merg de la 0 la size() - 1; verifică bucla și dacă lista nu s-a micșorat între timp. Î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.
