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

java.lang.IllegalStateException: Duplicate key Cluj (attempted merging values Ana and Dan)

Pe scurt

Collectors.toMap a primit două elemente cu aceeași cheie și nu știe ce valoare să păstreze. Dă-i al treilea argument, funcția de combinare: toMap(k, v, (a, b) -> a), sau folosește groupingBy dacă vrei toate valorile.

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. Un Map nu poate avea două chei egale, iar varianta cu două argumente nu știe ce să facă dacă apare o cheie a doua oară, așa că aruncă IllegalStateException: Duplicate key.

Mesajul îți arată cheia repetată și cele două valori aflate în conflict: Duplicate key Cluj (attempted merging values Ana and Dan). De aici știi imediat ce date se suprapun.

Ai trei variante, după ce vrei:

  • păstrezi una dintre valori: toMap(k, v, (prima, aDoua) -> prima);
  • le combini: toMap(k, v, (a, b) -> a + ", " + b) pentru texte sau (a, b) -> a + b pentru numere;
  • le păstrezi pe toate, grupate: groupingBy(k) sau groupingBy(k, mapping(v, toList())).

Eroarea apare deseori doar pe datele reale, când în datele de test toate cheile erau unice.

De ce apare: cauzele frecvente

1Chei repetate fără funcție de combinare

Greșit
JAVA
Map<String, String> peOras = clienti.stream()
    .collect(Collectors.toMap(Client::oras, Client::nume));
Corect
JAVA
Map<String, String> peOras = clienti.stream()
    .collect(Collectors.toMap(Client::oras, Client::nume, (a, b) -> a + ", " + b));

A treia funcție spune ce se întâmplă cu două valori pentru aceeași cheie: aici le unește.

2Vrei toate valorile pentru o cheie

Greșit
JAVA
Map<String, Integer> comenzi = lista.stream()
    .collect(Collectors.toMap(Comanda::client, Comanda::total));
Corect
JAVA
Map<String, List<Integer>> comenzi = lista.stream()
    .collect(Collectors.groupingBy(Comanda::client,
        Collectors.mapping(Comanda::total, Collectors.toList())));

groupingBy e făcut pentru chei care se repetă: adună toate valorile într-o listă.

Repară tu

Repară eroarea, direct în pagină

Programul face un Map de la oraș la clienți, dar se oprește cu IllegalStateException: Duplicate key Cluj. Repară colectarea, ca orașele cu mai mulți clienți să îi aibă uniți cu virgulă și programul să afișeze {Cluj=Ana, Dan, Iasi=Ion}.

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

public class Main {
    record Client(String nume, String oras) {}

    public static void main(String[] args) {
        List<Client> clienti = List.of(new Client("Ana", "Cluj"), new Client("Ion", "Iasi"), new Client("Dan", "Cluj"));
        Map<String, String> peOras = clienti.stream()
                .collect(Collectors.toMap(Client::oras, Client::nume));
        System.out.println(new TreeMap<>(peOras));
    }
}
După reparație, programul afișează
{Cluj=Ana, Dan, Iasi=Ion}
Indiciu

Collectors.toMap are o variantă cu un al treilea argument, care combină două valori pentru aceeași cheie.

Alte forme ale mesajului

  • java.lang.IllegalStateException: Duplicate key Cluj (attempted merging values Ana and Dan)
  • java.lang.IllegalStateException: Duplicate key 3
  • java.lang.IllegalArgumentException: duplicate key: a

Cum o eviți pe viitor

  • La toMap, întreabă-te dacă cheia e garantat unică. Dacă nu, dă mereu funcția de combinare.
  • Pentru sume pe cheie, folosește toMap(k, v, (a, b) -> a + b) sau groupingBy(k, summingInt(...)).
  • Pentru liste pe cheie, folosește groupingBy.
  • Testează cu date care conțin duplicate, nu doar cu exemple „curate”.

Întrebări frecvente

Ce e IllegalArgumentException: duplicate key?

E mesajul lui Map.of(...) când scrii aceeași cheie de două ori în lista de perechi. Acolo nu există funcție de combinare: trebuie să elimini dublura.

De ce map.put nu aruncă la cheie repetată?

put înlocuiește pur și simplu valoarea veche. toMap a fost proiectat să fie strict, ca să nu pierzi date fără să observi.

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.