HashMap允许一个null键（存于table[0]）和任意多个null值；get(null)返回null时无法区分键不存在或值为null，须用containsKey()或getOrDefault()判断。
HashMap 对 null 键和 null 值有明确且不同的处理方式：允许一个 null 键，存放在数组索引 0 的固定位置；允许多个 null 值，不做任何限制。但要注意，get() 返回 null 无法直接说明 key 是否存在，必须配合其他方法判断。
Null 键：强制落桶到索引 0
因为 null 没有 hashCode() 方法，无法参与常规哈希计算。HashMap 在 put() 中遇到 key == null 时，会跳过哈希计算，直接调用内部方法（如 putForNullKey）将键值对存入 table[0]。该位置可能是一个链表或红黑树节点，后续对 null 键的 get、remove 操作也都只查 table[0]。
- 整个 HashMap 中只能有一个 null 键——重复 put(null, v) 会覆盖旧值，不会新增条目
- table[0] 可能同时存有 null 键和其他非 null 键（如果它们哈希后也落在索引 0），但 null 键的查找不依赖哈希，只认 key == null 或 key.equals(null)
Null 值：完全放开，无校验
HashMap 不对 value 做任何 null 检查。只要 key 合法（包括是 null），value 就可以为 null。例如 map.put("a", null)、map.put("b", null)、map.put(null, "x") 可以共存。
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- null 值不影响存储结构，插入逻辑与非 null 值完全一致
- 遍历时 entry.getValue() 可能为 null，需自行判空，不能假设“有 entry 就一定有非 null 值”
Get 返回 null 时怎么判断语义？
这是使用 null 键/值最易出错的地方：map.get(key) == null 有两种可能——key 不存在，或 key 存在但 value 是 null。不能仅凭返回值下结论。
立即学习“Java免费学习笔记（深入）”；
- 用 map.containsKey(key) 先确认 key 是否存在，再决定是否取值
- 更推荐用 map.getOrDefault(key, defaultValue)，把“未命中”和“命中但为 null”统一成可预期的默认行为
- 避免在业务逻辑中直接 if (map.get(k) == null) { ... }，除非你 100% 确保该 key 对应的 value 永远不为 null
实际编码建议
虽然语言允许，但频繁使用 null 键或 null 值会增加理解成本和空指针风险。
- 尽量用有意义的占位键（如 "MISSING"）替代 null 键
- 对可能为 null 的 value，考虑用 Optional
包装（如 Map >），让空值语义更显式 - 在 put 前做校验（如 Objects.requireNonNull(key, "key must not be null")），尤其当该 Map 未来可能升级为 ConcurrentHashMap 时
