websocket控制帧仅有close（0x08）、ping（0x09）、pong（0x0a）三种，rfc 6455严格限定其opcode值，禁止分片（fin必须为1），负载长度不得超过125字节，且服务端发帧不可设mask位、客户端必须设，非法opcode或超长payload将导致连接被断开。
WebSocket控制帧有哪些，为什么不能随便发
WebSocket协议里只有三种控制帧：Close、Ping、Pong，其他值（比如0x03或0x07）都是非法的，对端收到会直接断连。RFC 6455明确规定控制帧的opcode必须是0x8（Close）、0x9（Ping）、0xa（Pong），且payload长度不能超过125字节——超长的Ping帧会被多数服务端（如gorilla/websocket）拒绝。
常见错误现象：websocket: bad close frame 或连接静默中断，往往是因为手动生成了非法opcode或payload过长。
- Go标准库
net/http不暴露控制帧构造能力，必须用第三方库（如gorilla/websocket）或手动编码 -
gorilla/websocket的WriteControl方法只接受websocket.CloseMessage、websocket.PingMessage、websocket.PongMessage三种类型，传其他值会panic - 手动构造时需注意mask位：服务端发控制帧**不能**设mask bit（即frame首字节第8位为0），客户端则必须设mask bit（为1），否则被当作协议错误
用gorilla/websocket安全发送控制帧的正确姿势
别自己拼二进制，直接用封装好的WriteControl最稳。它内部已处理opcode、长度校验、mask逻辑和错误返回。
示例：主动发Close帧并带原因字符串
err := conn.WriteControl(websocket.CloseMessage, websocket.FormatCloseMessage(websocket.CloseGoingAway, "server restart"), time.Now().Add(time.Second))
if err != nil {
// 注意：WriteControl可能返回io.ErrClosed，不是所有error都该重连
}
-
websocket.FormatCloseMessage必须用，它把原因字符串UTF-8编码+写入长度前缀，裸字符串直接传会触发协议错误 -
time.Now().Add(...)是超时控制，不是发送截止时间；超时后WriteControl会返回websocket.ErrCloseSent或io.ErrClosed -
Ping帧payload可以为空或任意≤125字节的[]byte，但Pong帧一般由库自动响应，无需手动发
手动解析控制帧时容易漏掉的关键检查
如果你在底层读原始frame（比如用conn.ReadMessage之外的方式），解析控制帧要逐项校验，缺一不可：
- 检查首字节低4位是否为
0x8、0x9、0xa——其他值直接丢弃并关闭连接 - 检查fin bit（首字节最高位）必须为1：控制帧不允许分片，
fin == 0就违反协议 - 检查payload length字段：若≥126，需读后续2或8字节扩展长度；总长度超过125立即拒绝
- 若mask bit为1（客户端帧），必须用mask key解密payload，否则
Ping内容错乱会导致心跳失败 -
Close帧的payload前2字节是reason code（uint16 network byte order），必须≥1000且≠1004/1005/1006等保留码
典型错误：只检查opcode，忽略fin位，结果把分片的data帧误判为控制帧，后续解析全乱。
自定义控制帧扩展的现实限制
想加新控制帧（比如Heartbeat）？RFC禁止，所有WebSocket实现都会拒收未知opcode。唯一合规做法是复用Ping/Pong承载自定义语义——例如在Ping payload里放JSON {"type":"heartbeat","seq":123}，对端收到后不调用DefaultCloseHandler而是走自定义逻辑。
- gorilla/websocket默认把
Ping转成Pong回发，需调用conn.SetPingHandler(nil)禁用自动响应，再用SetReadDeadline配合ReadMessage捕获 - 注意：
Ping帧无业务语义，中间代理（如nginx、CDN）可能丢弃或延迟，不能替代可靠的心跳确认 - 真正需要扩展语义时，应该用应用层消息类型字段（如JSON里的
"msg_type":"control"），而不是碰协议层
控制帧的边界很窄，看似简单，但每个字节都有RFC钉死的含义。越想绕过封装，越容易掉进协议兼容性坑里。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
