{"record":{"id":"06b3485a3ebcd001","repo":"eclipse-vertx/vert.x","slug":"unsupported-websocket-msg-msg","errorCode":null,"errorMessage":"Unsupported WebSocket msg ${msg}","messagePattern":"Unsupported WebSocket msg (.+?)","errorType":"exception","errorClass":"IllegalStateException","httpStatus":null,"severity":"error","filePath":"vertx-core/src/main/java/io/vertx/core/http/impl/websocket/WebSocketConnectionImpl.java","lineNumber":235,"sourceCode":"\n  private WebSocketFrameInternal decodeFrame(io.netty.handler.codec.http.websocketx.WebSocketFrame msg) {\n    ByteBuf payload = safeBuffer(msg.content());\n    boolean isFinal = msg.isFinalFragment();\n    WebSocketFrameType frameType;\n    if (msg instanceof BinaryWebSocketFrame) {\n      frameType = WebSocketFrameType.BINARY;\n    } else if (msg instanceof CloseWebSocketFrame) {\n      frameType = WebSocketFrameType.CLOSE;\n    } else if (msg instanceof PingWebSocketFrame) {\n      frameType = WebSocketFrameType.PING;\n    } else if (msg instanceof PongWebSocketFrame) {\n      frameType = WebSocketFrameType.PONG;\n    } else if (msg instanceof TextWebSocketFrame) {\n      frameType = WebSocketFrameType.TEXT;\n    } else if (msg instanceof ContinuationWebSocketFrame) {\n      frameType = WebSocketFrameType.CONTINUATION;\n    } else {\n      throw new IllegalStateException(\"Unsupported WebSocket msg \" + msg);\n    }\n    return new WebSocketFrameImpl(frameType, payload, isFinal);\n  }\n}\n","sourceCodeStart":217,"sourceCodeEnd":240,"githubUrl":"https://github.com/eclipse-vertx/vert.x/blob/fb308bd8c3f12c79f4ae89bef67fadf6c80d036e/vertx-core/src/main/java/io/vertx/core/http/impl/websocket/WebSocketConnectionImpl.java#L217-L240","documentation":"Protocol dispatch guard in WebSocketConnectionImpl.decodeFrame: the incoming Netty WebSocketFrame instance matched none of the known frame types (Binary, Close, Ping, Pong, Text, Continuation). The unmatched frame is appended to the message; this indicates an unexpected/extension frame type rather than user error.","triggerScenarios":"Thrown at vertx-core/src/main/java/io/vertx/core/http/impl/websocket/WebSocketConnectionImpl.java:235 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Upgrade Vert.x/Netty so the frame type is supported","Inspect the reported frame class to identify the extension or malformed frame source"],"exampleFix":null,"handlingStrategy":"type-guard","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"fb308bd8c3f12c79f4ae89bef67fadf6c80d036e","analyzedAt":"2026-09-06T11:37:12.241Z","contentChangedAt":"2026-09-06T11:37:12.241Z","schemaVersion":2},"datasetVersion":"2026-09-14T05:17:10.506Z"}