【Java】成功解决Java报错：java.lang.IllegalStateException

成功解决Java报错：java.lang.IllegalStateException。java.lang.IllegalStateException 是一种运行时异常，它表明方法被调用的时机或状态不合法。也就是说，程序当前的状态不适合执行这个操作。此异常通常用于表示状态机中的非法状态转换或者不支持某些操作的当前状态。

🧑 博主简介：
现任阿里巴巴嵌入式技术专家，15年工作经验，深耕嵌入式+人工智能领域，精通嵌入式领域开发、技术管理、简历招聘面试。CSDN优质创作者，提供产品测评、学习辅导、简历面试辅导、毕设辅导、项目开发、C/C++/Java/Python/Linux/AI等方面的服务，如有需要请站内私信或者联系任意文章底部的的VX名片（ID：gylzbk）

💬 博主粉丝群介绍：① 群内初中生、高中生、本科生、研究生、博士生遍布，可互相学习，交流困惑。② 热榜top10的常客也在群里，也有数不清的万粉大佬，可以交流写作技巧，上榜经验，涨粉秘籍。③ 群内也有职场精英，大厂大佬，可交流技术、面试、找工作的经验。④ 进群免费赠送写作秘籍一份，助你由写作小白晋升为创作大佬。⑤ 进群赠送CSDN评论防封脚本，送真活跃粉丝，助你提升文章热度。有兴趣的加文末联系方式，备注自己的CSDN昵称，拉你进群，互相学习共同进步。

问题背景

java.lang.IllegalStateException 是一种运行时异常，它表明方法被调用的时机或状态不合法。也就是说，程序当前的状态不适合执行这个操作。此异常通常用于表示状态机中的非法状态转换或者不支持某些操作的当前状态。

错误原因

1. 不合法的状态转换：比如在调用某个方法之前未进行必要的初始化。
2. 重复调用：某个操作被多次调用，但实际只能允许一次调用。
3. 资源未准备好：尝试在资源尚未准备好的情况下使用它。
4. 非法并发状态：多个线程试图以不合法的顺序或状态访问共享资源。

解决方案

1. 检查状态转换：在调用方法前，确保系统的状态符合预期。
2. 初始化检查：在操作之前，确保所有必要的资源和对象已经初始化。
3. 正确处理并发：使用适当的同步机制来确保线程安全。
4. 防止重复调用：确保同一操作不会被不合法地重复调用。

示例代码示范

假设你有一个表示网络连接的类，当连接未打开或者已经关闭时尝试发送数据将导致 IllegalStateException。

错误示例

public class NetworkConnection {
    private boolean isConnected = false;

    public void connect() {
        isConnected = true;
    }

    public void disconnect() {
        isConnected = false;
    }

    public void sendData(String data) {
        if (!isConnected) {
            throw new IllegalStateException("Cannot send data when connection is closed.");
        }
        // 发送数据逻辑
        System.out.println("Data sent: " + data);
    }

    public static void main(String[] args) {
        NetworkConnection connection = new NetworkConnection();
        connection.sendData("Hello");  // 未连接时发送数据，触发 IllegalStateException
    }
}

解决示例：检查状态

在调用 sendData 之前，确保连接状态已正确设置：

public class NetworkConnection {
    private boolean isConnected = false;

    public void connect() {
        isConnected = true;
    }

    public void disconnect() {
        isConnected = false;
    }

    public void sendData(String data) {
        if (!isConnected) {
            throw new IllegalStateException("Cannot send data when connection is closed.");
        }
        // 发送数据逻辑
        System.out.println("Data sent: " + data);
    }

    public static void main(String[] args) {
        NetworkConnection connection = new NetworkConnection();
        connection.connect();  // 首先连接
        connection.sendData("Hello");  // 连接后发送数据
        connection.disconnect();  // 断开连接
    }
}

使用初始化检查避免 IllegalStateException

确保所有初始化工作在调用方法之前完成：

public class Service {
    private boolean initialized = false;

    public void initialize() {
        // 完成初始化工作
        initialized = true;
    }

    public void performOperation() {
        if (!initialized) {
            throw new IllegalStateException("Service not initialized.");
        }
        // 执行操作逻辑
        System.out.println("Operation performed.");
    }

    public static void main(String[] args) {
        Service service = new Service();
        // service.initialize();  // 如果注释掉这句，会导致 IllegalStateException
        service.performOperation(); // 错误：服务未初始化
    }
}

解决示例：初始化检查

public class Service {
    private boolean initialized = false;

    public void initialize() {
        // 完成初始化工作
        initialized = true;
    }

    public void performOperation() {
        if (!initialized) {
            throw new IllegalStateException("Service not initialized.");
        }
        // 执行操作逻辑
        System.out.println("Operation performed.");
    }

    public static void main(String[] args) {
        Service service = new Service();
        service.initialize();  // 确保服务初始化
        service.performOperation();  // 执行操作
    }
}

并发环境中的 IllegalStateException

在多线程环境中，确保正确的状态同步以避免 IllegalStateException：

public class ConcurrentService {
    private boolean initialized = false;

    public synchronized void initialize() {
        // 完成初始化工作
        initialized = true;
    }

    public void performOperation() {
        synchronized (this) {
            if (!initialized) {
                throw new IllegalStateException("Service not initialized.");
            }
        }
        // 执行操作逻辑
        System.out.println("Operation performed.");
    }

    public static void main(String[] args) {
        ConcurrentService service = new ConcurrentService();

        Runnable task = () -> {
            try {
                service.performOperation();
            } catch (IllegalStateException e) {
                System.err.println("Caught IllegalStateException: " + e.getMessage());
            }
        };

        Thread thread1 = new Thread(task);
        Thread thread2 = new Thread(task);
        
        thread1.start();
        thread2.start();

        service.initialize();  // 初始化服务
        
        try {
            thread1.join();
            thread2.join();
        } catch (InterruptedException e) {
            e.printStackTrace();
        }
    }
}

输出示例

1. 未正确初始化

Exception in thread "main" java.lang.IllegalStateException: Service not initialized.
    at Service.performOperation(Service.java:11)
    at Service.main(Service.java:21)

2. 正确初始化后

Operation performed.

总结

java.lang.IllegalStateException 异常通常是由于方法调用的时机或状态不合法引起的。通过确保状态转换的合法性、在操作前进行初始化检查、正确处理并发环境下的状态同步以及防止重复调用，可以有效地避免和处理这类异常。