因为looplab/fsm默认不并发安全、允许绕过事件机制直接setstate、缺乏超时/回滚钩子，且非法事件静默忽略导致调试困难，需封装通道或锁模型并显式校验迁移条件。
为什么直接用 github.com/looplab/fsm 不够用
因为 looplab/fsm 默认不支持并发安全的状态转移，一旦多个 goroutine 同时调用 Event，可能触发 panic 或状态错乱。它内部用的是普通 map + mutex，但只保护了状态字段，没锁住事件处理逻辑本身——比如你在 Callback 里修改外部变量，依然会竞态。
常见错误现象：fatal error: concurrent map writes 或状态没变但日志显示“已触发事件”。
- 必须手动在所有
Event调用处加外部锁（比如sync.RWMutex），但容易漏 -
SetState是公开方法，可被任意代码绕过事件机制直接改状态，破坏状态机语义 - 没有内置超时、重试、回滚钩子，业务中要自己包一层
怎么让 fsm 支持并发安全且不可绕过
核心是把状态转移逻辑收口到一个带锁的通道驱动模型里，禁止直接访问状态字段。不是给 looplab/fsm 加锁，而是封装它。
实操建议：
- 定义私有结构体，内嵌
*fsm.FSM，但不暴露其Current、SetState等字段 - 所有状态变更统一走
Trigger(event string, payload interface{}) error方法，该方法内部用chan序列化事件（或用sync.Mutex包住fsm.Event调用） - 在
looplab/fsm的Callback中避免做耗时操作；如需异步响应，发消息到外部 channel，别阻塞状态机线程
示例关键片段：
type SafeFSM struct {
mu sync.Mutex
fsm *fsm.FSM
done chan struct{}
}
func (s *SafeFSM) Trigger(event string, payload interface{}) error {
s.mu.Lock()
defer s.mu.Unlock()
return s.fsm.Event(event, payload)
}
状态迁移失败时如何定位是条件不满足还是逻辑 bug
looplab/fsm 对非法事件默认静默忽略（返回 nil 错误），这让调试很痛苦。你调了 Event("pay")，状态没变，但不知道是因为当前状态不能触发 pay，还是 pay 的 transition 根本没配，还是 guard 函数返回 false。
解决方式：
- 初始化时用
fsm.NewFSM(..., fsm.DefaultTransitionEventNotDefined(func(event string) {}))替换默认行为，改成 panic 或打 error 日志 - 为每个 transition 显式配置
Cond（guard 函数），并在其中记录判断依据，例如：Cond: func(f fsm.FSM) bool { log.Printf("check balance >= %v, got %v", min, balance); return balance >= min } - 启用
fsm.Log：传入log.New(os.Stderr, "[fsm] ", 0)，它会输出每次尝试转移的 from/to/event 和结果
什么时候该放弃 fsm 库，手写 switch-case 状态机
当状态数 ≤ 5、事件数 ≤ 8、且状态逻辑高度耦合（比如每个状态都要读写同一组字段、共用大量上下文），用库反而增加心智负担和间接调用开销。
典型场景：
- 协议解析器（如 MQTT CONNECT 报文流转：waiting_header → reading_remaining → parsing_payload）
- 短生命周期任务状态（created → running → succeeded/failed），不需要持久化或事件审计
- 性能敏感路径（比如每秒万级订单的状态推进），
looplab/fsm的反射调用和 map 查找会带来 ~200ns 额外开销
手写要点：用 type State int 枚举 + func (s *Machine) HandleEvent(e Event) error，内部用 switch s.state 分支，每个分支明确列出允许的事件和副作用。好处是 IDE 可跳转、go vet 能检查未处理事件、编译期报错代替运行时报错。
容易被忽略的一点：手写状态机也要做“非法事件拦截”，别让 default: 分支默默吞掉意外输入——至少 log.Warn 或 panic。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
