HashMap允许且仅允许一个null键,因其hash(null)恒为0,故所有null键均定位到table[0];插入时通过==判断已有null键即覆盖,天然保证唯一性。

Java 中 HashMap 允许 key 为 null,且只允许一个 null key,这是由其内部实现逻辑决定的,不是靠额外校验,而是自然收敛的结果。
为什么 null key 总是放在数组索引 0 的位置
HashMap 的 put 和 get 方法在处理 null key 时会走特殊分支:不参与哈希计算(避免对 null 调用 hashCode() 抛出 NullPointerException),而是直接固定映射到数组下标 0 的桶(bucket)中。
具体来说:
-
hash(null)返回 0(JDK 8+ 中hash()方法对 null 返回 0) -
i = hash & (table.length - 1)→ 当 hash=0,无论 table 长度多少,i恒为 0(因为 0 与任何数按位与都是 0) - 所以所有
nullkey 都会被定位到table[0]
如何保证只有一个 null key
因为所有 null key 都落在同一个桶(table[0])里,后续插入时会遍历该桶中的链表或红黑树节点,逐个比较 key 是否为 null:
立即学习“Java免费学习笔记(深入)”;
Java开发手册规约集合,基于阿里巴巴Java开发手册(嵩山版)。 涵盖7大维度:编程规约、异常日志、单元测试、安全规约、MySQL数据库、工程结构、设计规约。
- 用
k == null判断(不是equals,因为 null 没有方法) - 一旦发现已有节点的 key 是
null,就直接覆盖 value,不会新增节点
这就天然实现了“最多一个 null key”的语义,无需额外标志位或特殊字段。
get(null) 是怎么查的
调用 get(null) 时:
- 同样算出 hash=0,定位到
table[0] - 遍历该桶内所有节点,对每个节点判断
e.key == null - 找到则返回对应 value;没找到则返回
null
注意:返回 null 不代表 key 不存在,可能是 key 存在但 value 为 null,所以要用 containsKey(null) 来准确判断。
实际使用中的注意事项
虽然语言支持,但生产代码中应谨慎使用 null 作为 key:
- 语义不清晰:
nullkey 往往表示“缺失”或“未定义”,和业务含义易混淆 - 容易引发误判:
map.get(x) == null无法区分“key 不存在”和“value 为 null” - 部分工具类或序列化框架(如 Jackson、FastJSON)对
nullkey 支持不一致,可能抛异常或静默丢弃 - 如果需要表达“无主键”或“默认配置”,建议用预定义常量(如
DEFAULT_KEY)替代null

















