Java中如何返回不可修改Map？为何无ImmutableMap类型？

java.util.Collections类提供的unmodifiableMap方法会创建一个Map的视图，使其无法被修改，但JDK中为何没有专门的ImmutableMap类型？

因为unmodifiableMap返回的是普通Map类型，很容易写出如下问题代码：

class SomeClass {
    private Map<String, Object> data = new HashMap<>();
    public Map<String, Integer> getData () {
        return Collections.unmodifiableMap(data);
    }
}

在其他调用代码中：

Map<String, Object> data = someClass.getData();
// 编译无警告，但运行时会抛出UnsupportedOperationException
data.put("count", 17);

上述代码编译时不会有任何警告，但运行时会直接抛出UnsupportedOperationException。

想请教两个问题：

• 应对这种情况的最佳方式是什么？
• 为什么java.util中没有专门的不可变Map类型？我原本期望有这样一个类型，能明确表示getData方法返回的是不可变对象——因为该类型本身就没有put这类修改方法，上面的错误代码根本无法通过编译。我是不是忽略了什么？

问题解答 #

为什么JDK没有内置ImmutableMap类型？

这主要是Java早期版本的设计取舍问题。JDK 1.2引入Collections.unmodifiableXXX系列方法时，更倾向于复用已有的Map/List等接口，而非新增一套不可变类型体系——这样能减少API复杂度，同时让代码更兼容已有的标准集合接口逻辑。但这种设计的代价就是无法在编译期阻止调用修改方法，只能在运行时抛出异常。

后续Java也补充了相关能力：Java 9新增的Map.of()、Map.ofEntries()等方法，返回的是JDK内部实现的不可变Map实例，不过对外仍标注为Map接口，尝试修改还是会在运行时抛异常，本质上还是没有提供专门的不可变接口。

应对编译期无警告、运行时抛异常的最佳方式

• 使用第三方库的不可变类型：比如Guava的ImmutableMap，它是专门的不可变Map实现，本身就没有修改方法。如果方法返回ImmutableMap类型，调用方尝试调用put等方法时会直接编译报错，从根源上避免问题。
• Java 9+原生方案：用Map.of()创建不可变Map，虽然返回的还是Map接口，但可以在方法签名和文档里明确标注这是不可变实例；也可以搭配Collections.unmodifiableMap使用，重点是在方法注释里强调返回的Map不可修改。
• 自定义不可变接口：如果不想引入第三方库，可以自己定义一个只保留查询方法的ImmutableMap接口，让unmodifiableMap返回的实例实现该接口，方法返回类型设为自定义的ImmutableMap，调用方就无法调用修改方法了。示例代码：

public interface ImmutableMap<K, V> {
    V get(Object key);
    boolean containsKey(Object key);
    // 仅保留查询类方法，移除所有修改方法
}

// 在业务类中使用
public ImmutableMap<String, Object> getData() {
    return (ImmutableMap<String, Object>) Collections.unmodifiableMap(data);
}

不过这种方式需要自行维护接口，不如成熟第三方库便捷。

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