已解决：java.lang.IllegalStateException: Duplicate key 异常的正确解决方法

在Java编程中，遇到java.lang.IllegalStateException: Duplicate key异常时，通常是由于在使用某些集合（如Map）时试图插入重复的键而导致的。这个问题在进行数据处理、集合操作或流处理时相对常见，尤其在Java 8及以后的版本中，使用Stream API时更容易出现此类问题。

异常原因

Duplicate key异常主要出现在两个场景中： 1. 使用Map接口实现类时，尝试往Map中放入相同的键。 2. 使用Stream API进行数据聚合时，如Collectors.toMap()，如果两个元素的键相同，则会抛出此异常。

示例代码

假设我们有一个Student类，包含id和name属性。我们希望根据学生的id将所有学生的name汇总到一个Map中。

import java.util.*;
import java.util.stream.Collectors;

class Student {
    private int id;
    private String name;

    public Student(int id, String name) {
        this.id = id;
        this.name = name;
    }

    public int getId() {
        return id;
    }

    public String getName() {
        return name;
    }
}

public class DuplicateKeyExample {
    public static void main(String[] args) {
        List<Student> students = Arrays.asList(
                new Student(1, "Alice"),
                new Student(2, "Bob"),
                new Student(1, "Charlie") // 重复的ID
        );

        try {
            Map<Integer, String> studentMap = students.stream()
                    .collect(Collectors.toMap(Student::getId, Student::getName)); // 这里会抛出异常
        } catch (IllegalStateException e) {
            System.out.println("发生异常: " + e.getMessage());
        }
    }
}

在上述代码中，由于Student类中有两个对象的ID为1，我们在将它们收集到Map时，会触发Duplicate key异常。

解决方案

要解决这个问题，我们可以通过定义一个合并函数来处理重复键。例如，如果我们想要保留最后一个元素的姓名，可以使用merge方法：

Map<Integer, String> studentMap = students.stream()
        .collect(Collectors.toMap(Student::getId, Student::getName, (existing, replacement) -> replacement));

在这个例子中，我们传递了一个合并函数 (existing, replacement) -> replacement，它简单地返回替换值，这样在遇到重复键的时候，后面的值将覆盖前面的值。

更加复杂的合并逻辑

如果我们想要合并重复键的值，可以进行更复杂的处理。例如，我们可以将相同键的name合并到一个List中：

Map<Integer, List<String>> studentMap = students.stream()
        .collect(Collectors.toMap(Student::getId, student -> Collections.singletonList(student.getName()),
                (existing, replacement) -> {
                    existing.addAll(replacement);
                    return existing;
                }));

System.out.println(studentMap);

在这个情况下，当我们遇到重复的键时，合并函数会将两个值合并成一个List，包含所有对应的姓名。

总结

java.lang.IllegalStateException: Duplicate key异常在Java中并不是罕见，理解其原因及解决方案对于开发人员非常重要。通过使用合并函数，可以灵活地处理重复的键。在日常开发中，我们需要谨慎对待数据的唯一性，确保在需要时采取适当的措施来避免或处理这类异常。