Java HashMap迭代顺序测试一致，为何文档称无顺序保证？

Java 11文档明确说明HashMap不保证映射顺序，还特别强调顺序可能随时间变化——但这不是说它每次迭代都必须不一样，而是告诉你：绝对不能依赖这个顺序写代码。你测试里顺序始终一致，只是因为所有影响元素存储位置的条件都没发生变化而已。

你的测试为啥顺序不变？ #

• String的哈希值固定：你用的key都是String，Java里同一个字符串的hashCode是固定不变的，而且这些key的哈希计算后，在HashMap数组里的位置没有冲突（或者冲突没影响迭代顺序）。
• 没触发扩容：HashMap默认初始容量是16，负载因子0.75，也就是说存到12个元素才会扩容。你只放了8个，数组大小一直是16，元素的存储位置不会因为扩容重新计算。
• 插入逻辑完全一致：两次创建HashMap都是按相同顺序插入相同的key，哈希计算和数组索引的映射完全一样，迭代顺序自然就相同。

怎么让HashMap顺序变化？ #

想复现顺序改变，试试这几个场景：

1. 触发扩容/重哈希 #

当元素数量超过扩容阈值时，HashMap会把数组容量翻倍，所有元素会重新计算哈希并分配到新数组的位置，迭代顺序就会变。比如修改代码，把初始容量设小一点：

// 初始容量设为4，阈值是4*0.75=3，放第4个元素就会扩容
HashMap<String, String> dishes = new HashMap<>(4);
// 按原来的顺序put完8个元素，迭代顺序会和初始容量16时不一样

2. 改变插入顺序 #

哪怕是相同的key集合，只要两次插入的顺序不同，就可能因为哈希冲突的处理逻辑（比如链表节点的顺序）导致迭代顺序变化。

3. 用哈希值可变的自定义对象当key #

如果自定义对象的hashCode()依赖可变属性，当属性改变后，对象的哈希值变了，再次put或操作时，元素在HashMap里的位置会改变，迭代顺序也会跟着变。

最后再强调一遍 #

HashMap的“不保证顺序”是官方给的免责声明——它明确告诉你，这个顺序随时可能因为扩容、JDK版本更新、甚至不同的运行环境而改变，你要是写了依赖这个顺序的代码，出问题自己负责。你的测试只是刚好碰到了稳定的场景，但这不能当成“HashMap顺序稳定”的依据。需要稳定顺序的话，直接用LinkedHashMap或者TreeMap就行。

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