在java状态机中抛出自定义异常，需在entry/exit/action、guard或事件处理器中主动throw runtimeexception子类异常，并确保框架不静默吞掉；spring sm会包装为statemachineexception，squirrel原样抛出，推荐统一异常基类并带错误码。
在 Java 状态机（如 Spring State Machine、Squirrel、或自研状态机）中抛出自定义异常，核心思路是：**在状态流转的钩子（如 entry/exit/action）、条件判断、或事件处理器中主动 throw 异常，并确保该异常不被框架静默吞掉**。关键在于异常的传播路径和框架的错误处理机制。
明确异常抛出的位置
状态流转中可抛异常的典型位置包括：
- 状态进入动作（entry action）：比如进入“审核中”前校验申请人权限，不满足则 throw InsufficientPermissionException
- 状态退出动作（exit action）：比如离开“已支付”状态前检查退款规则，违规则 throw InvalidRefundStateException
-
事件触发条件（guard）：guard 方法返回 false 时本不执行流转；若需更明确报错，可在 guard 内直接 throw 异常（部分框架支持，如 Spring State Machine 的
Guard允许抛出运行时异常） - 自定义事件处理器（event handler）：在接收外部事件后、调用状态机 sendEvent 前做前置校验，失败即抛异常，避免无效流转请求进入状态机
确保异常能穿透框架并被业务捕获
不同状态机对异常的处理策略不同，需针对性配置：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
-
Spring State Machine：默认会将 action/guard 中抛出的
RuntimeException包装为StateMachineException并向上抛出。建议自定义异常继承RuntimeException，避免被当作业务正常返回而忽略 -
Squirrel State Machine：在
StateAction或Guard中 throw 异常会中断流转，并原样抛出——无需额外包装，但需确保调用方 try-catch -
手写状态机：在
transition()方法中显式 catch 异常并 re-throw，或设计为 throws 声明，让调用方决定如何处理
推荐做法：统一异常基类 + 明确错误码
便于日志追踪与前端提示，建议定义状态机专用异常体系：
public class StateMachineException extends RuntimeException {
private final String errorCode;
public StateMachineException(String errorCode, String message) {
super(message);
this.errorCode = errorCode;
}
// getter...
}
public class InvalidStateTransitionException extends StateMachineException {
public InvalidStateTransitionException(String from, String to) {
super("STATE_TRANSITION_INVALID",
String.format("Cannot transition from %s to %s", from, to));
}
}
在 guard 或 action 中直接使用：
if (!user.hasRole("ADMIN")) {
throw new InvalidStateTransitionException("DRAFT", "PUBLISHED");
}
避免常见陷阱
- 不要在
toString()、hashCode()等基础方法中抛异常，可能引发不可预期的 NPE 或死循环 - 慎用 checked exception：多数状态机框架只设计处理 unchecked 异常，强制 try-catch 反而破坏流程清晰性
- 异步状态机（如带 TaskExecutor 的 Spring SM）中抛异常，需确认异常是否在主线程可捕获——必要时通过
Future.get()或回调获取 - 日志记录建议在抛出前打 warn 日志，包含当前状态、事件、上下文 ID，方便问题定位
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
