Java中IllegalStateException常见问题解析

在Java开发中，`IllegalStateException`异常用于指示对象当前状态不允许执行特定操作，这与`IllegalArgumentException`参数错误不同。本文深入解析`IllegalStateException`的常见应用场景，包括对象未连接时尝试发送数据、资源（如线程池）已关闭后继续使用、方法调用顺序错误以及迭代过程中检测到并发修改等情况。通过具体示例，如自定义连接类、线程池任务提交、构建器模式和手动实现迭代保护，展示如何在代码中有效利用`IllegalStateException`提升程序的健壮性和可维护性，帮助开发者及早发现并处理逻辑错误，确保程序在正确状态下运行。掌握`IllegalStateException`的使用，能更清晰地向调用者传达“当前状态不允许此操作”的信息。

IllegalStateException用于对象状态不合法时禁止方法调用，如未连接时发送数据、资源已关闭后继续使用、方法调用顺序错误或迭代中并发修改，语义清晰表明“当前状态不允许此操作”。

IllegalStateException 用于表示对象当前所处的状态不适合调用某个方法。当一个对象的方法在特定状态下不能被调用时，抛出此异常是合理且语义清晰的选择。它属于运行时异常（RuntimeException），不需要强制捕获或声明。

1. 对象状态不满足方法调用条件

当对象未处于预期状态却尝试执行某操作时，应抛出 IllegalStateException。

示例：自定义连接类

public class Connection {
    private boolean connected = false;

    public void connect() {
        connected = true;
        System.out.println("连接成功");
    }

    public void sendData(String data) {
        if (!connected) {
            throw new IllegalStateException("连接未建立，无法发送数据");
        }
        System.out.println("发送数据: " + data);
    }

    public static void main(String[] args) {
        Connection conn = new Connection();
        // conn.sendData("Hello"); // 抛出 IllegalStateException
        conn.connect();
        conn.sendData("Hello"); // 正常执行
    }
}

2. 资源已被释放或关闭

当资源（如流、线程池、数据库连接）已经被关闭，再次使用时应阻止操作并提示非法状态。

示例：线程池提交任务

ExecutorService executor = Executors.newSingleThreadExecutor();
executor.shutdown();

// 再次提交任务会抛出 IllegalStateException
try {
    executor.submit(() -> System.out.println("任务执行"));
} catch (IllegalStateException e) {
    System.out.println("无法提交任务：线程池已关闭");
}

3. 方法调用顺序错误

某些方法必须按特定顺序调用。如果调用顺序错误，可使用 IllegalStateException 提醒使用者。

示例：构建器模式中重复构建

public class PersonBuilder {
    private String name;
    private int age;
    private boolean built = false;

    public PersonBuilder setName(String name) {
        if (built) throw new IllegalStateException("Person 已构建完成，不可修改");
        this.name = name;
        return this;
    }

    public PersonBuilder setAge(int age) {
        if (built) throw new IllegalStateException("Person 已构建完成，不可修改");
        this.age = age;
        return this;
    }

    public Person build() {
        if (built) throw new IllegalStateException("Person 只能构建一次");
        built = true;
        return new Person(name, age);
    }
}

4. 迭代过程中并发修改检测

Java 集合框架中的许多迭代器会在检测到并发修改时抛出 ConcurrentModificationException，它继承自 RuntimeException，但部分自定义集合可能直接使用 IllegalStateException 表达类似语义。

示例：手动实现迭代保护

public class SimpleList {
    private List data = new ArrayList<>();
    private int modCount = 0;

    public Iterator iterator() {
        int expected = modCount;
        return new Iterator() {
            public boolean hasNext() {
                checkModification();
                return ...;
            }

            public T next() {
                checkModification();
                ...
            }

            private void checkModification() {
                if (modCount != expected) {
                    throw new IllegalStateException("列表在迭代过程中被修改");
                }
            }
        };
    }

IllegalStateException 的核心在于“状态非法”，而不是参数错误（那是 IllegalArgumentException 的职责）。它帮助开发者更早发现逻辑错误，提升代码的健壮性和可维护性。

基本上就这些场景最常见。用好这个异常，能让调用者清楚知道“不是不能做，而是现在不能做”。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~