Collections.emptyMap() 返回一个不可变的空映射实例,用于避免返回 null 以减少空指针异常。该方法属于 java.util.Collections 类,返回共享的、类型为 Map 的空映射,任何修改操作均抛出 UnsupportedOperationException。常用于方法无数据时的安全返回、变量初始化或集合操作默认值。建议指定泛型以增强类型安全,如需可变空映射应使用 new HashMap() 等方式替代。

在Java中,Collections.emptyMap() 是一种创建不可变空映射(即空的 Map)的标准方式。它属于 java.util.Collections 类的静态方法,用于返回一个共享的、不可修改的空映射实例。
emptyMap 方法简介
Collections.emptyMap() 返回一个类型为 Map 的空映射,这个映射不包含任何键值对。由于它是不可变的,任何试图修改它的操作(如 put、remove)都会抛出 UnsupportedOperationException 异常。
该方法的主要用途是作为默认返回值,避免返回 null,从而减少空指针异常的风险。
基本使用方式
调用 Collections.emptyMap() 非常简单:
立即学习“Java免费学习笔记(深入)”;
- 直接调用方法获取一个空的 Map 实例
- 建议指定泛型类型以增强类型安全
import java.util.Collections;
import java.util.Map;
public class EmptyMapExample {
public static void main(String[] args) {
// 创建一个空映射
Map emptyMap = Collections.emptyMap();
// 或者不指定泛型(不推荐)
Map empty = Collections.emptyMap();
System.out.println(emptyMap.size()); // 输出:0
// emptyMap.put("key", 1); // 这行会抛出 UnsupportedOperationException
}
}
实际应用场景
该方法常用于以下场景:
- 方法需要返回一个 Map,但当前没有数据时,返回 emptyMap 比返回 null 更安全
- 初始化变量时作为默认值
- 配合其他集合操作使用,例如合并或过滤后的结果为空时提供默认映射
public MapfindUsersByRole(String role) { List users = database.queryByRole(role); if (users == null || users.isEmpty()) { return Collections.emptyMap(); // 安全返回空映射 } // ... 构建 map 并返回 }
基本上就这些。使用 Collections.emptyMap() 是一种简洁、高效且安全的方式创建空映射,尤其适合用作默认返回值。注意它是不可变的,如需可变空映射,应使用 new HashMap() 等方式替代。










