Spring Boot STOMP WebSocket Python客户端握手200错误求助
核心问题根源
“Handshake status 200 OK”报错的本质是协议协商未完成,和跨域、权限配置无关,是两端的WebSocket通信协议栈错配导致的
- Spring端暴露的是STOMP over WebSocket复合协议端点,不是原生裸WebSocket端点
- Python客户端直接发起普通WebSocket连接时,没有携带STOMP要求的子协议协商请求头,Spring端识别不到合法的STOMP连接升级请求,会直接把该请求当普通HTTP GET处理,返回200状态码,连接根本不会升级为WebSocket会话
- 就算连接流程侥幸推进到消息发送阶段,客户端发出的STOMP帧缺少协议要求的换行终止符,也会被服务端直接丢弃
具体修复步骤
- 调整Python客户端连接逻辑
补全握手时的STOMP子协议请求头,替换原来的直连代码:
如果之前Spring端点配置加了import websocket import stomper import random # 握手阶段携带STOMP子协议标识 ws = websocket.create_connection( "ws://localhost:8080/ws", header=["Sec-WebSocket-Protocol: v12.stomp"] )withSockJS(),需要把连接路径改为/ws/websocket,SockJS会把原生WebSocket的请求路径挂载在这个子路径下。 - 修正STOMP帧发送格式
按照STOMP协议规范,每个发送的帧结尾必须追加\n作为帧结束标记,修改订阅和发消息的代码:client_id = str(random.randint(0, 1000)) # 订阅主题,结尾补换行 sub = stomper.subscribe("/topic/greeting", client_id, ack='auto') ws.send(sub + "\n") # 发送业务消息,结尾补换行 ws.send(stomper.send("/app/greeting", "Hello there") + "\n") - 简化Spring端端点配置
Python客户端不需要SockJS的浏览器兼容能力,把registerStompEndpoints中的withSockJS()配置移除,避免路径匹配混乱:@Override public void registerStompEndpoints(StompEndpointRegistry stompEndpointRegistry) { // 移除withSockJS(),仅保留原生STOMP端点配置 stompEndpointRegistry.addEndpoint("/ws").setAllowedOrigins("*"); }
注意事项
- 不要用普通浏览器地址栏访问
/ws端点,非WebSocket升级的GET请求本来就会返回200,这是Spring端的正常行为,不代表连接成功 - 接收消息时需要过滤掉STOMP协议的心跳空帧,不要把包含换行的空帧当成异常
内容的提问来源于stack exchange,提问作者FlorianR
相关产品推荐
相关产品推荐

