IllegalStateException用于表示对象状态不支持当前操作，常见于迭代器遍历结束、关闭资源后写入、线程重复启动等场景；通过主动抛出该异常可明确表达非法状态调用，提升代码健壮性；建议结合isXxx()方法提供状态检查，预防异常发生，同时在必要时捕获并记录日志以增强容错能力。
在Java开发中，IllegalStateException 是一种常见的运行时异常，表示对象当前状态不允许调用某个方法。它通常用于防止对象在不恰当的状态下执行非法操作。正确处理和使用这个异常，有助于提升代码的健壮性和可维护性。
理解IllegalStateException的触发场景
这个异常不是由外部输入错误引起的，而是反映对象内部状态与方法调用之间的逻辑冲突。常见场景包括：
- 调用next()方法前未调用hasNext()，如Iterator遍历结束后的继续调用
- 向已关闭的流或资源写入数据，例如关闭的OutputStream再write()
- 线程状态不满足操作前提，比如对已启动的线程再次调用start()
- 构建器模式中，在已经构建完成的对象上继续添加配置
这些情况都表明：对象处于一个“不允许当前操作”的状态。
主动抛出IllegalStateException控制流程
在设计类时，应通过校验对象状态来决定是否允许方法执行。如果当前状态不满足条件，直接抛出IllegalStateException更清晰地表达语义。
立即学习“Java免费学习笔记（深入）”；
示例：一个简单的任务执行器
public class TaskRunner {
private boolean running = false;
public void start() {
if (running) {
throw new IllegalStateException("Task is already running");
}
running = true;
// 启动任务逻辑
}
public void stop() {
if (!running) {
throw new IllegalStateException("Task is not running");
}
running = false;
}
}
这种做法让调用方立刻意识到使用方式错误，而不是产生难以排查的静默失败或数据错乱。
合理捕获与日志记录
虽然IllegalStateException是运行时异常，通常不建议广泛捕获，但在某些边界场景下，适当捕获并处理可以增强系统容错能力。
- 在API接口层统一捕获，返回友好的错误响应
- 关键业务流程中记录日志，便于问题追踪
- 测试代码中验证异常是否按预期抛出
示例：Spring MVC中通过@ControllerAdvice统一处理
@ExceptionHandler(IllegalStateException.class)
public ResponseEntity<String> handleIllegalState(IllegalStateException e) {
log.warn("Invalid state operation: {}", e.getMessage());
return ResponseEntity.badRequest().body("Operation not allowed in current state");
}
预防优于处理：提供状态查询方法
良好的API设计应让调用者能预先判断能否执行某操作。为此，建议为关键状态提供isXxx()类型的方法。
延续上面TaskRunner的例子：
public boolean isRunning() {
return running;
}
这样调用方可以安全检查：
if (!taskRunner.isRunning()) {
taskRunner.start();
}
既避免了异常，也提升了代码可读性。
基本上就这些。关键是把对象状态管理当作设计的一部分，用IllegalStateException明确表达“不允许”，并通过合理的API设计减少误用。不复杂但容易忽略。
