java.lang.UnsupportedOperationException: null
Ai încercat să modifici o colecție imuabilă: List.of, Map.of, Set.of, Stream.toList() sau Collections.unmodifiableList nu acceptă add/remove/put. Creează o copie modificabilă (new ArrayList<>(List.of(...))) când ai nevoie să schimbi conținutul.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Colecțiile create cu List.of(...), Map.of(...), Set.of(...), rezultatul lui stream().toList() (Java 16+) și cele împachetate cu Collections.unmodifiableList sunt imuabile. Orice încercare de modificare (add, remove, put, clear, set, sort) aruncă UnsupportedOperationException. Excepția nu are mesaj, de aceea log-ul arată UnsupportedOperationException: null; indiciul e în stiva de apeluri: at java.base/java.util.ImmutableCollections.uoe(...).
Într-un API, apare tipic când inițializezi datele unui serviciu în memorie cu List.of(...), iar apoi ruta POST încearcă să adauge. Clientul primește 500.
Arrays.asList(...) e un caz intermediar: permite set, dar nu add/remove, cu aceeași excepție. Reparația: copiază într-o colecție modificabilă (new ArrayList<>(...), new HashMap<>(...)) sau, dacă imuabilitatea era intenționată, nu modifica lista, ci construiește una nouă.
De ce apare: cauzele frecvente
1Adaugi într-o listă creată cu List.of
private final List<String> produse = List.of("Mouse");
...
produse.add(nume);private final List<String> produse = new ArrayList<>(List.of("Mouse"));
...
produse.add(nume);ArrayList e modificabilă; List.of nu.
2Modifici rezultatul lui toList()
List<Produs> ieftine = produse.stream().filter(...).toList();
ieftine.sort(comparator);List<Produs> ieftine = new ArrayList<>(produse.stream().filter(...).toList());
ieftine.sort(comparator);Stream.toList() întoarce o listă imuabilă. Sortează în stream sau copiază întâi.
3Ștergi dintr-o listă Arrays.asList
List<String> l = Arrays.asList("a", "b");
l.remove("a");List<String> l = new ArrayList<>(Arrays.asList("a", "b"));
l.remove("a");Arrays.asList are dimensiune fixă.
Repară eroarea, direct în pagină
POST /produse?nume=Cablu răspunde 500 cu UnsupportedOperationException, pentru că lista de produse a fost creată cu List.of. Inițializează lista ca o colecție modificabilă, păstrând produsele de pornire, ca adăugarea să funcționeze și GET /produse să arate și produsul nou.
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.*;
import org.springframework.stereotype.*;
import org.springframework.beans.factory.annotation.*;
import org.springframework.http.*;
import java.util.*;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@RestController
class ProdusController {
private final List<String> produse = List.of("Mouse", "Tastatură");
@GetMapping("/produse")
List<String> toate() {
return produse;
}
@PostMapping("/produse")
String adauga(@RequestParam String nume) {
produse.add(nume);
return "Adăugat: " + nume;
}
}Tomcat started on port 8080 (http) Started Application POST /produse?nume=Cablu → 200 Adăugat: Cablu GET /produse → 200 ["Mouse","Tastatură","Cablu"]
Indiciu
new ArrayList<>(List.of(...)) face o copie modificabilă.
Reparația
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.*;
import org.springframework.stereotype.*;
import org.springframework.beans.factory.annotation.*;
import org.springframework.http.*;
import java.util.*;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@RestController
class ProdusController {
private final List<String> produse = new ArrayList<>(List.of("Mouse", "Tastatură"));
@GetMapping("/produse")
List<String> toate() {
return produse;
}
@PostMapping("/produse")
String adauga(@RequestParam String nume) {
produse.add(nume);
return "Adăugat: " + nume;
}
}De ce merge
List.of creează o listă imuabilă: perfectă pentru constante, dar add aruncă UnsupportedOperationException fără mesaj, iar Spring răspunde 500. new ArrayList<>(List.of(...)) copiază elementele într-o listă modificabilă, deci ruta de adăugare funcționează, iar listarea arată produsul nou. Într-o aplicație reală datele ar sta într-o bază de date, nu într-un câmp.
Alte forme ale mesajului
java.lang.UnsupportedOperationException at java.base/java.util.ImmutableCollections.uoejava.lang.UnsupportedOperationException at java.base/java.util.AbstractList.add
Cum o eviți pe viitor
- Folosește
List.ofpentru date care nu se schimbă (constante, rezultate întoarse) șinew ArrayList<>()pentru stare modificabilă. - Când un câmp e o colecție modificată de mai multe metode, inițializează-l explicit ca
ArrayList/HashMap. - Citește stiva:
ImmutableCollections.uoeînseamnă mereu o colecție imuabilă. - Întoarce din servicii copii sau liste imuabile, ca apelanții să nu-ți modifice starea.
Întrebări frecvente
De ce mesajul e null?
Excepția este aruncată fără text. Informația utilă e în stiva de apeluri, la rândul cu ImmutableCollections.
E Collectors.toList() la fel?
Nu: Collectors.toList() întoarce în practică o ArrayList modificabilă (fără garanție în documentație). Stream.toList() e garantat imuabilă.
Erori înrudite
Servlet.service() for servlet [dispatcherServlet] in context with path [] threw exception [Request processing failed: java.lang.IllegalStateException: Stoc insuficient pentru Mouse] with root cause O excepție aruncată din controller sau serviciu nu a fost tratată nicăieri, a ajuns până la servlet, iar clientul a primit 500. Excepția reală e în paranteze și în stiva de sub mesaj. Repar-o sau trateaz-o cu un @ExceptionHandler care întoarce statusul potrivit. There was an unexpected error (type=Internal Server Error, status=500). Rândul din pagina Whitelabel spune că o excepție netratată a produs 500. Cauza e în log. Pentru excepțiile tale de business, adaugă @ResponseStatus pe clasa excepției sau un @ExceptionHandler, ca să răspunzi cu codul potrivit (404, 409). Cannot invoke "Produs.nume()" because the return value of "java.util.Map.get(Object)" is null Ai apelat o metodă pe rezultatul lui map.get(cheie), dar cheia nu există și get a întors null, deci NullPointerException și 500. Verifică rezultatul înainte (sau folosește getOrDefault / Optional) și răspunde 404 pentru cheile lipsă. Învață Spring Boot de la zero, cu exerciții la fiecare lecție
Curs Spring Boot și REST API: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 18 lecții sunt gratuite.
