IllegalStateException在Java中用于表示对象处于不合法状态时的方法调用，常见于迭代器、流操作、数据库连接及自定义状态机等场景。例如，未调用hasNext()就调用next()、对已关闭的流进行读写、或在播放器已播放时再次调用play()。该异常属于运行时异常，无需强制捕获，但建议在关键路径中通过逻辑判断预防，如使用hasNext()控制循环而非依赖try-catch。最佳实践包括：方法内校验状态并主动抛出带清晰信息的异常、提供isConnected()类状态查询方法、文档注明可能抛出条件、优先用流程控制避免异常，并记录日志以便排查。核心是通过设计减少非法状态出现，提升程序健壮性。
在Java中，IllegalStateException 是一种运行时异常（RuntimeException），表示对象处于不适合调用某个方法的状态。它通常由程序逻辑错误引起，比如在未初始化的对象上调用方法，或在不允许的时机调用某个操作。
何时抛出 IllegalStateException
该异常常见于以下场景：
- 调用迭代器的 next() 方法前未调用 hasNext() 或已遍历完元素
- 在未连接的数据库连接对象上执行查询
- 在已经关闭的流上进行读写操作
- 使用 Scanner 对象时源已关闭但仍尝试读取
- 自定义对象状态机中，调用了当前状态不支持的方法
如何捕获与处理
虽然 IllegalStateException 是运行时异常，不需要强制捕获，但在某些关键路径中建议显式处理以增强健壮性。
示例：安全使用 Iterator
立即学习“Java免费学习笔记（深入）”；
Iterator<String> iterator = list.iterator();
try {
while (true) {
System.out.println(iterator.next());
}
} catch (IllegalStateException e) {
System.err.println("迭代器状态异常：" + e.getMessage());
}
更推荐的做法是通过逻辑判断避免异常：
Iterator<String> iterator = list.iterator();
while (iterator.hasNext()) {
System.out.println(iterator.next());
}
自定义业务中的非法状态处理
在设计状态敏感的对象时，可主动抛出 IllegalStateException 来防止误用。
例如一个简单的播放器状态控制：
public class MediaPlayer {
private boolean isPlaying = false;
public void play() {
if (isPlaying) {
throw new IllegalStateException("播放器已经在播放状态");
}
isPlaying = true;
System.out.println("开始播放");
}
public void stop() {
if (!isPlaying) {
throw new IllegalStateException("播放器未在播放状态，无法停止");
}
isPlaying = false;
System.out.println("停止播放");
}
}
调用时应先判断状态或使用 try-catch 包装：
try {
player.play();
player.play(); // 第二次调用将抛出异常
} catch (IllegalStateException e) {
System.out.println("操作失败：" + e.getMessage());
}
最佳实践建议
处理 IllegalStateException 的核心是预防而非被动捕获。
- 在方法内部校验对象状态，必要时主动抛出清晰信息的异常
- 提供状态查询方法（如 isConnected()、isActive()）供调用者判断
- 文档中明确标注哪些方法可能抛出此异常及触发条件
- 优先通过流程控制避免异常，而不是依赖 try-catch 捕获
- 日志记录异常信息以便排查问题根源
