在Java开发中，合并两个Map对象是十分常见的操作需求，比如整合不同数据源的配置信息、汇总多个模块的计算结果等场景都会用到。不同的合并方式在性能、代码简洁度和冲突处理逻辑上各有不同，开发者需要根据实际场景选择最合适的方法。
使用putAll方法合并Map
putAll是Map接口自带的基础方法，它的逻辑是将指定Map中的所有键值对复制到当前Map中，如果存在重复的键，那么后放入的键值对会覆盖原有的值。这种方法实现简单，代码可读性高，适合不需要处理键值冲突或者允许覆盖冲突值的场景。
下面是使用putAll合并两个Map的示例代码：
import java.util.HashMap;
import java.util.Map;
public class MapMergeDemo {
public static void main(String[] args) {
// 创建第一个Map
Map<String, Integer> map1 = new HashMap<>();
map1.put("a", 1);
map1.put("b", 2);
// 创建第二个Map
Map<String, Integer> map2 = new HashMap<>();
map2.put("b", 3);
map2.put("c", 4);
// 使用putAll合并，map2的键值对会覆盖map1中重复的键
map1.putAll(map2);
// 输出合并后的结果
System.out.println(map1); // 输出 {a=1, b=3, c=4}
}
}
使用Java8的merge方法合并Map
Java8在Map接口中新增了merge方法，这个方法可以自定义键值冲突时的处理逻辑，比putAll更加灵活。merge方法接收三个参数：键key、要合并的值value、一个BiFunction函数用来处理键冲突的情况。如果键不存在，就直接放入键值对；如果键存在，就使用函数处理旧值和新值得到最终结果。
下面是使用merge方法合并Map的示例代码，冲突时选择两个值相加：
import java.util.HashMap;
import java.util.Map;
public class MapMergeDemo2 {
public static void main(String[] args) {
Map<String, Integer> map1 = new HashMap<>();
map1.put("a", 1);
map1.put("b", 2);
Map<String, Integer> map2 = new HashMap<>();
map2.put("b", 3);
map2.put("c", 4);
// 遍历map2，使用merge合并，冲突时两个值相加
map2.forEach((key, value) -> map1.merge(key, value, (oldVal, newVal) -> oldVal + newVal));
System.out.println(map1); // 输出 {a=1, b=5, c=4}
}
}
使用Stream API合并Map
Java8的Stream API也可以实现Map的合并，这种方式适合需要对合并过程做更多过滤、转换操作的场景。我们可以通过Stream将两个Map的entry合并成一个流，再通过收集器转换成新的Map。同样可以在收集过程中定义冲突处理逻辑。
下面是使用Stream API合并Map的示例代码：
import java.util.HashMap;
import java.util.Map;
import java.util.stream.Collectors;
import java.util.stream.Stream;
public class MapMergeDemo3 {
public static void main(String[] args) {
Map<String, Integer> map1 = new HashMap<>();
map1.put("a", 1);
map1.put("b", 2);
Map<String, Integer> map2 = new HashMap<>();
map2.put("b", 3);
map2.put("c", 4);
// 使用Stream合并两个Map，冲突时取新值
Map<String, Integer> resultMap = Stream.concat(map1.entrySet().stream(), map2.entrySet().stream())
.collect(Collectors.toMap(
Map.Entry::getKey,
Map.Entry::getValue,
(oldVal, newVal) -> newVal // 冲突处理逻辑，这里取新值
));
System.out.println(resultMap); // 输出 {a=1, b=3, c=4}
}
}
不同合并方法的对比
为了帮助开发者选择合适的合并方法，下面从性能、灵活性、适用场景三个维度对比几种常见方法：
| 合并方法 | 性能 | 灵活性 | 适用场景 |
|---|---|---|---|
| putAll | 较高，底层是循环复制数组 | 低，只能覆盖冲突值 | 无冲突处理需求，允许覆盖的场景 |
| merge | 较高，单元素操作开销小 | 高，可自定义冲突逻辑 | 需要自定义冲突处理，比如值相加、取最大值等场景 |
| Stream API | 较低，Stream有额外开销 | 极高，可结合过滤、转换等操作 | 合并过程中需要做额外数据处理，比如过滤无效键值对的场景 |
合并Map的注意事项
- 合并前需要确认两个Map的键值类型一致，否则会出现类型转换异常。
- 如果Map的value是引用类型，合并时需要注意浅拷贝的问题，避免修改合并后的Map影响原Map的数据。
- 当Map的数据量非常大时，优先选择putAll或者merge方法，避免使用Stream API带来不必要的性能损耗。
- 如果合并的Map中有null值，需要提前确认是否允许null，部分合并逻辑可能会抛出空指针异常。
JavaMapmergeputAllStream_API修改时间：2026-07-03 11:15:28