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

java.lang.IllegalStateException: Duplicate key A1 (attempted merging values 2 and 3)

Pe scurt

Collectors.toMap a primit două elemente cu aceeași cheie și nu știe pe care să-l păstreze. Dă-i al treilea argument, funcția de combinare (de exemplu (a, b) -> a + b), sau folosește groupingBy când vrei toate valorile pe cheie.

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

Ce înseamnă

Collectors.toMap(cheie, valoare) construiește un Map din elementele unui stream. Implicit, presupune că fiecare cheie apare o singură dată. Dacă două elemente produc aceeași cheie, aruncă IllegalStateException: Duplicate key A1 (attempted merging values 2 and 3). Mesajul îți dă cheia repetată și cele două valori care se ciocnesc.

În aplicațiile Spring apare când transformi rezultatele dintr-un repository sau dintr-un alt serviciu într-un Map: stocul din mai multe depozite pentru același cod, comenzi ale aceluiași client, traduceri cu aceeași cheie. Codul merge cu datele de test (unde cheile sunt unice) și cade în producție la primul duplicat, cu 500.

Rezolvarea depinde de ce înseamnă duplicatul: îl aduni, îl păstrezi pe primul sau pe ultimul, ori ai nevoie de o listă de valori pentru fiecare cheie.

De ce apare: cauzele frecvente

1Valorile duplicate trebuie adunate

Greșit
JAVA
intrari.stream()
    .collect(Collectors.toMap(Intrare::cod, Intrare::bucati));
Corect
JAVA
intrari.stream()
    .collect(Collectors.toMap(Intrare::cod, Intrare::bucati, (a, b) -> a + b));

Al treilea argument spune ce faci cu două valori pentru aceeași cheie: aici le aduni.

2Ai nevoie de toate elementele pe cheie

Greșit
JAVA
Map<Long, Comanda> peClient = comenzi.stream()
    .collect(Collectors.toMap(Comanda::clientId, c -> c));
Corect
JAVA
Map<Long, List<Comanda>> peClient = comenzi.stream()
    .collect(Collectors.groupingBy(Comanda::clientId));

groupingBy păstrează toate elementele cu aceeași cheie, într-o listă.

3Duplicatul nu ar trebui să existe

Greșit
JAVA
// cheia e numele produsului, care se poate repeta
toMap(Produs::getNume, p -> p)
Corect
JAVA
// cheia e id-ul, unic
toMap(Produs::getId, p -> p)

Alege drept cheie un câmp cu adevărat unic, de exemplu id-ul.

Repară tu

Repară eroarea, direct în pagină

GET /stoc/total răspunde 500 cu Duplicate key A1: produsul A1 este în două depozite. Răspunsul trebuie să fie totalul pe cod, adunat din toate depozitele: {"A1":5,"B2":7}.

Codul care dă eroarea
JAVA
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.*;
import java.util.*;
import java.util.stream.Collectors;

@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

record Intrare(String depozit, String cod, int bucati) { }

@RestController
class StocController {
    private final List<Intrare> intrari = List.of(
            new Intrare("Cluj", "A1", 2), new Intrare("Iași", "A1", 3),
            new Intrare("Cluj", "B2", 7));

    @GetMapping("/stoc/total")
    Map<String, Integer> total() {
        // TODO: același cod apare în mai multe depozite: adună bucățile
        return intrari.stream()
                .collect(Collectors.toMap(Intrare::cod, Intrare::bucati));
    }
}
După reparație, programul afișează
Tomcat started on port 8080 (http)
Started Application
GET /stoc/total → 200
{"A1":5,"B2":7}
Indiciu

toMap are o variantă cu al treilea argument: ce faci cu două valori pentru aceeași cheie?

Alte forme ale mesajului

  • java.lang.IllegalStateException: Duplicate key A1
  • IllegalStateException: Duplicate key Mouse (attempted merging values Produs[id=1] and Produs[id=4])

Cum o eviți pe viitor

  • Ori de câte ori folosești toMap, întreabă-te dacă cheia poate apărea de două ori.
  • Dă funcția de combinare explicit ((a, b) -> a + b, (a, b) -> a).
  • Folosește groupingBy când o cheie are mai multe valori.
  • Pune în datele de test și un caz cu chei repetate.

Întrebări frecvente

De ce codul a mers în teste și a picat în producție?

Datele de test aveau chei unice. Excepția apare doar când există un duplicat, deci adaugă un astfel de caz în teste.

Cum păstrez ordinea cheilor în Map?

Folosește varianta cu patru argumente: toMap(k, v, (a, b) -> a + b, LinkedHashMap::new) sau TreeMap::new pentru chei sortate.

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.