两个键值相同的Map<String,Object>调用equals返回false如何解决

问题复现 #

你遇到的问题对应代码如下：

Map<String, Object> map1 = new HashMap<String, Object>();
Map<String, Object> map2 = new HashMap<String, Object>(); 

// map1包含键值对：{SD="BBBBBB", DNN="Internet", SST=2}
// map2包含键值对：{SD="BBBBBB", DNN="Internet", SST=2}

map1.equals(map2) // 输出false

原因说明 #

HashMap的原生equals()方法本身设计为：只要两个Map的键值对完全匹配（key相等且对应value相等）就返回true。出现上述异常结果的最常见原因是值的类型不匹配：比如map1中SST对应的值是Integer类型的2，map2中SST对应的值是String类型的"2"，二者equals()判断为不相等，最终导致整个Map的比较结果为false。如果value是自定义类对象，也可能是自定义类没有重写equals()和hashCode()方法导致的。

解决方法 #

方法1：直接使用原生equals()（推荐）

只要保证两个Map所有键对应的值类型和内容都完全一致，原生的map1.equals(map2)就会返回true，示例：

map1.put("SD", "BBBBBB");
map1.put("DNN", "Internet");
map1.put("SST", 2); // Integer类型

map2.put("SD", "BBBBBB");
map2.put("DNN", "Internet");
map2.put("SST", 2); // 同样为Integer类型，与map1一致

map1.equals(map2); // 此时返回true

方法2：自定义比较逻辑适配特殊场景

如果你需要忽略类型差异（比如Integer(2)和String("2")判定为相等），或者需要忽略指定字段，可以自己实现比较方法，示例：

public static boolean mapsAreEqual(Map<String, Object> map1, Map<String, Object> map2) {
    // 先判空和长度
    if (map1 == map2) return true;
    if (map1 == null || map2 == null || map1.size() != map2.size()) return false;
    // 逐个比对键值对
    for (Map.Entry<String, Object> entry : map1.entrySet()) {
        String key = entry.getKey();
        Object value1 = entry.getValue();
        Object value2 = map2.get(key);
        // 此处可自定义相等规则，示例为转字符串比较忽略类型差异
        if (value1 == value2) continue;
        if (value1 == null || !String.valueOf(value1).equals(String.valueOf(value2))) {
            return false;
        }
    }
    return true;
}

调用上述自定义方法即可按照你的预期规则判断两个Map是否相等。

内容的提问来源于stack exchange，提问作者divya