如何在 Java 中使用 Iterator.next() 配合 NoSuchElementException 编写健壮的自定义迭代器

在 Ja va 里写一个自定义迭代器，很多新手容易犯的错误是试图在 next() 方法里偷偷处理越界情况，或者干脆返回 null。其实，正确的做法恰恰相反——你得明确告诉调用方：什么时候该抛异常，就理直气壮地抛。Ja va 的 Iterator 合约明明白白写在那里：next() 必须在 hasNext() 返回 false 时抛出 NoSuchElementException。这可不是什么异常情况，它就是协议的一部分。

严格遵守 Iterator 协议：hasNext() 是 next() 的守门人

next() 方法本身不该去操心“还有没有下一个”，它的职责很简单：返回当前游标指向的元素，然后推进内部状态。真正的防护逻辑必须交给 hasNext()：

• hasNext() 应该快速、无副作用地检查是否还有可返回的元素（比如检查索引是否越界、链表节点是否为 null）
• next() 被调用时，默认前提是 hasNext() 已经被正确调用并且返回了 true；如果外部直接跳过 hasNext() 连续调用 next()，那就按照规范抛 NoSuchElementException
• 千万别在 next() 里重复检查或者悄悄返回 null——那等于破坏契约，让使用者分不清“空值元素”和“已经没东西了”

next() 中抛出 NoSuchElementException 的典型写法

拿最简单的数组迭代器举例，核心逻辑一目了然：

private final String[] data;
private int cursor = 0;

public boolean hasNext() {
    return cursor < data.length;
}

public String next() {
    if (!hasNext()) {
        throw new NoSuchElementException();
    }
    return data[cursor++];
}

注意两个细节：

• 判断条件用的是 !hasNext() 而不是 cursor >= data.length——保持逻辑复用，避免重复条件
• 抛出的是无参构造的 NoSuchElementException，不用加消息，标准库就是这么干的

处理边界与并发：增强健壮性的实用技巧

真实场景下还得考虑更多：

• fail-fast 检查：在 next() 开头就校验迭代器是否被外部修改（比如集合结构变了），立即抛 ConcurrentModificationException，比等到越界才崩更能提前暴露问题
• 空集合/空源安全：如果底层数据可能为 null，在构造时就校验并抛 NullPointerException，别等到 next() 才手忙脚乱
• 不可变游标状态：确保 cursor 这类状态变量是私有且不可被外部修改；必要时用 final 或者封装访问
• 泛型安全：老老实实声明 类型参数，避免用原始类型擦除导致运行时类型错误

测试健壮性的关键用例

单元测试要覆盖协议的边界：

• 空集合：连续调用 next() → 第一次就抛 NoSuchElementException
• 单元素集合：hasNext() → true，next() → 元素，再 hasNext() → false，再 next() → 抛异常
• 标准循环遍历：用 while (it.hasNext()) { it.next(); } 能完整走完，不抛异常
• 跳过 hasNext() 直接多次调用 next()：必须稳定抛异常（验证契约的强制性）

不复杂，但很容易被忽略。