Spring WebSocketClient连接GDAX沙箱环境失败问题排查

我之前也踩过这个坑——Spring WebSocketClient连GDAX生产环境顺风顺水，一切换到沙箱就直接罢工，多半是环境间的细微配置差异或者沙箱的特殊要求没满足，咱们一步步来排查解决：

1. 先确认身份验证与订阅消息的正确性 #

GDAX沙箱对消息格式的要求比生产环境更严格，而且身份验证是完全独立的：

• 如果是匿名连接，务必确保发送的订阅消息格式完全合规，比如：

  {
    "type": "subscribe",
    "product_ids": ["BTC-USD"],
    "channels": ["ticker"]
  }
  

• 如果用身份验证，必须去GDAX沙箱后台重新生成专属的API密钥、密码和通行证，生产环境的密钥在沙箱里完全无效。

2. 调整Spring WebSocketClient的配置参数 #

沙箱环境的网络握手速度可能更慢，或者需要明确指定子协议，咱们调整下客户端的核心配置：

• 延长连接和空闲超时时间，避免因为超时导致连接失败：

  StandardWebSocketClient client = new StandardWebSocketClient();
  client.setConnectTimeout(10000); // 把连接超时设为10秒
  client.setDefaultMaxSessionIdleTimeout(30000); // 空闲超时设为30秒
  

• 明确指定json子协议，GDAX的WebSocket服务依赖这个协议才能正常通信：

  WebSocketHttpHeaders headers = new WebSocketHttpHeaders();
  headers.add("Sec-WebSocket-Protocol", "json");
  // 连接时带上这个headers
  client.execute(yourHandler, socketURL, headers).get();
  

3. 排查网络层面的问题 #

有时候不是代码的锅，是公司防火墙或代理把沙箱的域名拦截了。先试试用命令行工具（比如wscat）直接连接沙箱地址：

wscat -c wss://ws-feed-public.sandbox.gdax.com

如果命令行都连不上，那就得找运维团队开放沙箱域名的访问权限；如果命令行能连，那回到代码里继续排查配置细节。

4. 强制使用TLS 1.2协议 #

GDAX沙箱要求使用TLS 1.2及以上版本的加密协议，而有些旧版本的Spring或JVM默认用了更低的TLS版本，导致握手失败：

• 可以在JVM启动参数里添加：

  -Dhttps.protocols=TLSv1.2
  

• 或者在代码启动时直接设置：

  System.setProperty("https.protocols", "TLSv1.2");
  

适配沙箱的完整测试代码 #

我把上面的要点整合到了一个可运行的示例里，你可以直接参考：

import org.springframework.web.socket.client.standard.StandardWebSocketClient;
import org.springframework.web.socket.TextMessage;
import org.springframework.web.socket.WebSocketHttpHeaders;
import org.springframework.web.socket.WebSocketSession;
import org.springframework.web.socket.handler.TextWebSocketHandler;

import java.util.concurrent.CountDownLatch;

public class GdaxSandboxTest {
    public static void main(String[] args) throws InterruptedException {
        String socketURL = "wss://ws-feed-public.sandbox.gdax.com";
        CountDownLatch latch = new CountDownLatch(1);

        StandardWebSocketClient client = new StandardWebSocketClient();
        client.setConnectTimeout(10000);
        client.setDefaultMaxSessionIdleTimeout(30000);

        WebSocketHttpHeaders headers = new WebSocketHttpHeaders();
        headers.add("Sec-WebSocket-Protocol", "json");

        client.execute(new TextWebSocketHandler() {
            @Override
            public void afterConnectionEstablished(WebSocketSession session) throws Exception {
                System.out.println("沙箱连接成功！");
                String subscribeMsg = "{\"type\": \"subscribe\", \"product_ids\": [\"BTC-USD\"], \"channels\": [\"ticker\"]}";
                session.sendMessage(new TextMessage(subscribeMsg));
            }

            @Override
            protected void handleTextMessage(WebSocketSession session, TextMessage message) throws Exception {
                System.out.println("收到消息：" + message.getPayload());
            }

            @Override
            public void handleTransportError(WebSocketSession session, Throwable exception) throws Exception {
                System.err.println("连接出错：" + exception.getMessage());
                latch.countDown();
            }
        }, socketURL, headers).get();

        latch.await();
    }
}

按照这些步骤排查，应该就能解决沙箱环境的连接问题了。

内容的提问来源于stack exchange，提问作者Nitin