IllegalStateException用于表示对象状态不合法时的方法调用，如未初始化、已关闭资源操作或非法状态转移，应在方法入口检查状态并抛出带具体信息的异常，结合状态模式、清晰文档和单元测试管理状态流转，将其作为系统自我保护机制而非缺陷。
在Java开发中，IllegalStateException 是一个运行时异常，通常用于表示对象当前所处的状态不允许调用某个方法。例如，对已关闭的资源再次执行操作、在未初始化完成前调用业务方法等。合理使用该异常有助于提升代码的健壮性和可维护性。关键不在于“避免”它，而在于如何正确地抛出、捕获和设计对象状态流转逻辑来保证其语义清晰。
理解 IllegalStateException 的适用场景
IllegalStateException 属于编程错误类异常，应由开发者在编码阶段预防，而不是在生产环境中频繁捕获。常见触发场景包括：
- 调用方法时对象尚未初始化（如未调用 init()）
- 对已关闭的对象执行操作（如关闭后的 OutputStream 再 write）
- 状态机中非法的状态转移（如订单从“已取消”变为“待支付”）
- 多线程环境下状态被意外修改导致不一致
这类问题本质是对象生命周期管理不当。通过明确状态定义和检查机制，可以有效控制异常发生。
通过状态检查主动抛出异常
在方法入口处验证对象当前状态，若不符合预期则立即抛出 IllegalStateException，防止后续逻辑出错。这种方式比让程序默默失败或产生更严重错误更安全。
立即学习“Java免费学习笔记（深入）”；
示例：连接池中的连接使用public void executeQuery(String sql) {
if (this.connection == null) {
throw new IllegalStateException("数据库连接未建立，无法执行查询");
}
if (this.closed) {
throw new IllegalStateException("连接已关闭，不能执行操作");
}
// 执行查询
}
提示信息应具体说明原因，便于调试。不要只写 "Illegal state" 这样模糊的内容。
使用状态模式管理复杂状态流转
当对象具有多个状态且行为随状态变化时，推荐采用状态模式（State Pattern），将状态判断逻辑封装到独立类中，避免大量 if-else 判断导致的状态失控。
示例：订单状态控制public interface OrderState {
void ship(OrderContext context);
}
public class PendingState implements OrderState {
public void ship(OrderContext context) {
context.setStatus(new ShippedState());
}
}
public class CanceledState implements OrderState {
public void ship(OrderContext context) {
throw new IllegalStateException("已取消的订单不能发货");
}
}
通过不同状态实现类决定是否允许某操作，非法操作自然转化为有意义的异常，同时提高扩展性。
结合断言与文档明确前置条件
除了运行时检查，还应在 Javadoc 中明确标注方法调用的前提条件。配合单元测试验证边界情况，确保状态约束被正确理解和使用。
/**
* 提交任务到执行队列。
* @throws IllegalStateException 如果任务已被提交或已取消
*/
public void submit() {
if (status != Status.CREATED) {
throw new IllegalStateException("任务必须处于创建状态才能提交");
}
status = Status.SUBMITTED;
}
良好的文档能减少误用，配合 IDE 提示提前发现问题。
基本上就这些。关键是把对象看作有生命的实体，它的每一个方法调用都依赖于当前所处的“生命阶段”。只要状态清晰、检查到位、反馈明确，IllegalStateException 就不是缺陷，而是系统自我保护的机制。
