...
Eroare Spring Boot · Excepții și răspunsuri de eroare

java.lang.UnsupportedOperationException: null

Pe scurt

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

Greșit
JAVA
private final List<String> produse = List.of("Mouse");
...
produse.add(nume);
Corect
JAVA
private final List<String> produse = new ArrayList<>(List.of("Mouse"));
...
produse.add(nume);

ArrayList e modificabilă; List.of nu.

2Modifici rezultatul lui toList()

Greșit
JAVA
List<Produs> ieftine = produse.stream().filter(...).toList();
ieftine.sort(comparator);
Corect
JAVA
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

Greșit
JAVA
List<String> l = Arrays.asList("a", "b");
l.remove("a");
Corect
JAVA
List<String> l = new ArrayList<>(Arrays.asList("a", "b"));
l.remove("a");

Arrays.asList are dimensiune fixă.

Repară tu

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.

Codul care dă eroarea
JAVA
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;
    }
}
După reparație, programul afișează
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ă.

Alte forme ale mesajului

  • java.lang.UnsupportedOperationException at java.base/java.util.ImmutableCollections.uoe
  • java.lang.UnsupportedOperationException at java.base/java.util.AbstractList.add

Cum o eviți pe viitor

  • Folosește List.of pentru date care nu se schimbă (constante, rezultate întoarse) și new 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

← Toate erorile Spring Boot

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ță 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.