You need to enable JavaScript to run this app. Spring Boot STOMP WebSocket Python客户端握手200错误求助
优惠活动
大模型
产品
解决方案
定价
更多

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子协议请求头,替换原来的直连代码:
    import websocket
    import stomper
    import random
    
    # 握手阶段携带STOMP子协议标识
    ws = websocket.create_connection(
        "ws://localhost:8080/ws",
        header=["Sec-WebSocket-Protocol: v12.stomp"]
    )
    
    如果之前Spring端点配置加了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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.05 10:06:03