Cursor生成的Go状态机常漏掉net.Conn生命周期管理、缺少default分支和并发安全控制、未注入context.Context、未处理TCP粘包半包问题。
Cursor 生成的 Go 状态机常漏掉 net.Conn 生命周期管理
cursor 对网络通信状态机的自动补全，容易把连接建立、读写、关闭当成纯逻辑流转，忽略 net.conn 的实际生命周期。比如它可能生成一个状态切换函数，但没在 stateclosed 时调用 conn.close()，也没处理 io.eof 或 net.errclosed 这类底层错误——结果就是连接泄漏或 panic。
实操建议：
- 所有状态跳转前，先检查
conn != nil && !conn.IsClosed()（需自行封装IsClosed，Go 标准库不直接暴露） - 在
StateConnecting到StateConnected的跃迁中，必须用conn.SetDeadline()设超时，否则阻塞读写会卡死整个状态机 - 生成后立刻搜索
defer conn.Close()—— 它不该出现在顶层函数里，而应绑定到每个具体状态的退出路径上（例如从StateReading跳出时）
状态枚举和 switch 分支容易忽略 default 和并发安全
Cursor 常按模板生成类似 type State int + const ( StateInit State = iota ... )，但紧接着的 switch s { case StateInit: ... } 往往缺 default 分支。而 Go 的 net.Conn.Read() 可能返回 0, nil（对端静默关闭），此时状态可能非法，没 default 就直接 panic。
实操建议：
- 强制在每个状态处理
switch后加default: return fmt.Errorf("invalid state: %d", s)，并让错误携带当前conn.RemoteAddr() - 如果状态机被多个 goroutine（如读/写协程）共享，不要用裸
state字段；改用atomic.LoadInt32(&s.state)+atomic.CompareAndSwapInt32控制跃迁 - 避免在
case StateWriting:中直接调用conn.Write()—— 改为写入带锁的sync.Pool缓冲区，由单独 writer goroutine 统一刷出
context.Context 没被注入到状态流转链路里
Cursor 生成的状态机函数通常形如 func (s *StateMachine) HandleEvent(e Event) error，但没把 context.Context 作为参数传入。这导致无法响应取消（比如客户端断连、服务端关机）、无法设置 per-request 超时、也无法透传 trace ID。
实操建议：
- 所有公开状态方法签名改为
func (s *StateMachine) HandleEvent(ctx context.Context, e Event) error - 在
StateReading中，用conn.SetReadDeadline(time.Now().Add(5 * time.Second))不够 —— 必须监听ctx.Done()并主动中断conn.Read()（通过关闭 conn 或设 deadline 为过去时间） - 在
StateConnected初始化阶段，用ctx = context.WithValue(ctx, connKey, conn)注入连接实例，后续各状态可安全取用，避免闭包捕获导致的内存泄漏
生成代码没覆盖 TCP 粘包与半包场景
Cursor 默认按“一次 Read() 对应一个完整业务包”建模，但真实 TCP 流是字节流。它可能生成 if len(buf) >= headerSize { parseHeader(buf) }，却没处理 len(buf) 的情况，导致状态卡死在 StateReadingHeader，永远等不到下一次 Read。
实操建议：
- 每个读状态都得有缓冲区字段（如
pendingBuf []byte），Read()返回n, err后，先append(pendingBuf, buf[:n]...)，再尝试解析 - 解析失败且
len(pendingBuf) 时，不跳转状态，直接 return 等下次 Read；否则才触发StateParsing跃迁 - 在
StateParsing中，用binary.Read(bytes.NewReader(pendingBuf), binary.BigEndian, &header)替代手动切片，避免字节序错位引发的无限重试
真正难的不是写出状态切换逻辑，而是让每个状态都知道自己该等什么、能等多久、等不到时该向谁报错。Cursor 生成的骨架只是起点，这些细节一旦漏掉，程序会在高并发下随机丢连接、卡住或 OOM。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
