IllegalStateException 是程序逻辑进入非法状态时抛出的运行时异常,如 Iterator 未调用 hasNext() 就调用 next()、已关闭的 Scanner 再读取、重复 start() 已启动线程等,需通过前置状态校验而非捕获来避免。

IllegalStateException 是什么状态?
它不是代码写错了,而是程序逻辑走到了「不该走」的状态——比如调用 next() 前没调用 hasNext(),或对已关闭的 InputStream 再次读取。JVM 不阻止你写这种调用,但运行时发现对象内部状态不满足前置条件,就抛出 IllegalStateException。
哪些常见场景会触发它?
这个异常高频出现在状态敏感的类中,尤其是 JDK 自带的集合、IO 和并发工具类:
-
Iterator在未调用hasNext()或已遍历完后调用next() -
Scanner在已调用close()后继续调用nextLine() -
Thread对已启动(STARTED)或已终止(TERMINATED)的线程重复调用start() -
AtomicInteger的某些自定义封装逻辑中,手动检查状态后主动 throw(例如「只能初始化一次」的配置类)
怎么避免和定位?
关键不是“捕获它”,而是提前防御——因为它是程序员该负责的逻辑错误,不是外部异常。排查重点在状态流转是否被跳过或重复:
- 检查循环中
Iterator的使用:必须严格遵循while (it.hasNext()) { it.next(); }模式 - 确认资源生命周期:
Scanner、ZipInputStream等关闭后不可再用,别复用已 close 的实例 - 线程操作前加判断:
if (thread.getState() == Thread.State.NEW) { thread.start(); } - 自定义状态类里,用私有字段记录当前状态(如
private volatile State state = State.INITIAL;),所有 public 方法开头校验
能 catch 吗?要不要 log?
可以 catch,但不推荐作为兜底策略。它意味着你漏掉了某个状态检查,修复代码比 try-catch 更根本。如果真要 log,务必带上上下文状态:
立即学习“Java免费学习笔记(深入)”;
try {
value = parser.parse();
} catch (IllegalStateException e) {
log.error("Parser in invalid state: {}", parser.getState(), e);
throw e; // 不建议吞掉,除非你明确知道如何恢复
}
真正难处理的是多线程下状态竞争导致的偶发 IllegalStateException——这时候问题不在单行代码,而在状态同步缺失,得回溯整个状态变更路径。










