Hashtable 实际上 不支持 null 的 key 和 value，这是一种常见误解。

---

一句话回答：

Hashtable 不允许 key 或 value 为 null。
尝试 put 或 get 时使用 null，会抛出 NullPointerException。

---

一、官方文档说明

来自 Java 官方文档：

Neither the key nor the value can be null.

官方链接：Hashtable (Java SE 8)

---

二、验证代码示例

import java.util.Hashtable;

public class TestHashtable {
    public static void main(String[] args) {
        Hashtable<String, String> table = new Hashtable<>();

        table.put("name", "Alice");  // ✅ 正常
        // table.put(null, "value"); // ❌ 抛出 NullPointerException
        // table.put("key", null);   // ❌ 抛出 NullPointerException
    }
}

输出（运行时异常）：

Exception in thread "main" java.lang.NullPointerException

---

三、为什么不支持 null？

1. Hashtable 是早期并发安全类

• Hashtable 是 Java 1.0 就存在的类，其设计目标是线程安全。
• 内部方法普遍加了 synchronized 修饰，意味着多个线程可并发访问。
• 在多线程中处理 null 的行为容易产生语义歧义和并发风险。

比如：

String value = table.get("key"); // 返回 null

你很难判断是：

• key 存在但 value 是 null？
• 还是 key 根本不存在？

因此：为避免歧义，直接禁止 null。

---

2. 源代码验证

public synchronized V put(K key, V value) {
    if (key == null || value == null) {
        throw new NullPointerException();
    }
    ...
}

• Hashtable 明确抛出 NullPointerException
• 目的是提前失败（fail-fast），避免后续复杂逻辑错误

---

🔍 四、与 HashMap 的对比

特性	Hashtable	HashMap
是否线程安全	是	否（需手动同步）
是否允许 null key	不允许	允许一个 null key
是否允许 null value	不允许	允许多个 null value
适用场景	老旧线程安全需求	通用 + 高性能需求

---

五、总结一句话

Hashtable 出于线程安全和语义清晰的考虑，不允许 key 或 value 为 null。推荐用 ConcurrentHashMap 替代。

---

推荐替代方案

场景	替代方案
多线程安全 Map	ConcurrentHashMap
单线程或自己控制并发	HashMap
允许 null 且需线程安全	Collections.synchronizedMap() 包装 HashMap

---

更多详细内容请关注其他相关文章！