ceilingkey 返回 null 的常见原因是 treemap 中无键 ≥ 目标值，如键集 {1,5,23} 调用 ceilingkey(100) 必返回 null；需先用 lastkey() 确认目标未超最大键，且注意 null 键抛 npe、比较逻辑一致性及自定义 comparator 的陷阱。
ceilingKey 返回 null 的常见原因
调用 ceilingKey 却得到 null，不是方法失效，而是当前 TreeMap 中**没有任何键 ≥ 目标值**。比如 map.ceilingKey(100) 在键集为 {1, 5, 23} 时必然返回 null——因为 100 太大了。
注意：这和 get 找不到 key 返回 null 不同，ceilingKey 的 null 意味着“下界不存在”，不是空指针异常前兆，但容易误判为逻辑错误。
- 务必先确认目标值未超过
TreeMap最大键（可用lastKey()检查） - 若目标值本身是
null，且TreeMap允许null键（默认不允许），会抛NullPointerException - 键的比较逻辑必须一致：自定义类作 key 时，
compareTo或Comparator不能与equals冲突，否则查找行为不可靠
正确使用 ceilingKey 的典型场景
最常用在「时间范围对齐」「价格档位匹配」「分数段归类」这类需要向上取整键的业务中。例如订单按创建时间分片，想查“不早于 2024-05-20 14:30:00 的第一个分片起始时间”：
TreeMap<localdatetime string> slices = new TreeMap(); slices.put(LocalDateTime.of(2024, 5, 20, 14, 0), "slice-A"); slices.put(LocalDateTime.of(2024, 5, 20, 14, 30), "slice-B"); slices.put(LocalDateTime.of(2024, 5, 20, 15, 0), "slice-C"); <p>LocalDateTime target = LocalDateTime.of(2024, 5, 20, 14, 25); LocalDateTime ceiling = slices.ceilingKey(target); // 返回 14:30:00 对应的键</p></localdatetime>
- 输入值不必是 map 中真实存在的键，只要可比较即可
- 返回的是键本身，不是键值对；如需值，再用
get(ceiling) - 若目标值恰好等于某个键，直接返回该键（即“等于优先于大于”）
ceilingKey 和 higherKey 的关键区别
ceilingKey(k) 找 ≥ k 的最小键，higherKey(k) 找 > k 的最小键。差一个“等于”条件，结果可能完全不同：
- 当
k存在于 map 中：ceilingKey(k)返回k，higherKey(k)返回下一个更大的键（或null） - 当
k不存在但有更小键：ceilingKey仍可能返回有效键（只要存在 ≥ k 的），higherKey要求严格大于 - 性能无差异，都是 O(log n)，但语义选错会导致业务逻辑偏移——比如做“首次达标时间”必须用
ceilingKey，用higherKey会跳过刚好达标的那一刻
自定义 Comparator 下的陷阱
用带 Comparator 的构造器初始化 TreeMap 时，ceilingKey 完全依赖该比较器，和自然顺序无关。常见翻车点：
- 比较器返回 0 表示相等，但若逻辑写成
return o1.x - o2.x可能溢出，导致查找失败 - 比较器中用了外部状态（如某变量值），而该状态在查找时已变更，结果不可预测
- 比较器未处理
null输入（即使你确定不会传null），某些 JDK 版本会在内部校验时抛异常
建议：Comparator 实现始终用 Integer.compare(a, b) 或 Objects.compare，避免手写减法；测试时用边界值（最小、最大、中间）覆盖查找路径。
ceilingKey 看似简单，真正难的是确保键的有序性从插入到查询全程受控——尤其是多线程写入后立即查询，忘了加同步或用了非线程安全的包装，就可能看到“明明插了却查不到”的假象。
