Gorilla Golang WebSocket的IsUnexpectedCloseError在Windows下不生效问题

算力阿峰

2026-9-30

问题原因分析

websocket.IsUnexpectedCloseError() 仅用于识别WebSocket协议层面的关闭异常：只有当对端按照WebSocket规范发送了关闭帧，但关闭状态码不在预期范围内时，该方法才会返回true。
你遇到的wsarecv: An existing connection was forcibly closed by the remote host是Windows系统Winsock层返回的TCP连接重置错误，属于操作系统层面的网络异常：对端直接发送RST包断开TCP连接，没有走WebSocket标准关闭握手流程，websocket库不会将这类错误封装为CloseError类型，因此判断返回false。

是不是bug？

既不是框架BUG，也不属于实现错误，属于漏覆盖了TCP层异常的场景。

处理方案

新增TCP层连接异常的判断逻辑：Go 1.13及以上版本可以通过标准库的错误判断能力识别连接重置类错误，Windows下的wsarecv连接重置错误会被映射为syscall.ECONNRESET，可直接匹配：

import (
    "errors"
    "syscall"
    "github.com/gorilla/websocket"
)

// 原有逻辑调整为
messageType, data, err := myWebsocket.ReadMessage()
if err != nil {
    var closeErr *websocket.CloseError
    // 先判断是否为WebSocket协议层关闭错误
    if errors.As(err, &closeErr) {
        if websocket.IsUnexpectedCloseError(err) {
            log.Debugf("WebsocketReadDataMessage: unexpected close error: %v", err)
        } else {
            log.Debugf("WebsocketReadDataMessage: expected close: %v", err)
        }
    } else if errors.Is(err, syscall.ECONNRESET) || errors.Is(err, syscall.ECONNABORTED) {
        // 匹配TCP层连接重置/中断错误，包含Windows下的wsarecv重置错误
        log.Debugf("WebsocketReadDataMessage: connection reset by peer: %v", err)
    } else {
        log.Warnf("WebsocketReadDataMessage: other error: %v", err)
    }
    return err
}