Spring Boot Socket客户端连接Node.js服务端遇EngineIOException求助

1. 修正Socket.IO路径配置 #

你Node.js客户端里的path参数设置有误——*path*应该是Socket.IO服务的相对路径（而非完整URL）。虽然Node.js客户端可能自动兼容了这个错误，但Java客户端对路径格式更严格。修改Spring Boot代码中的Options，添加正确的路径配置：

IO.Options options = IO.Options.builder()
        .setPath("/socket.io") // 替换为相对路径，而非完整URL
        .setAuth(singletonMap("token","abcd"))
        .build();

Socket socket = IO.socket(URI.create("https://localhost:3000"), options);
socket.connect();

2. 处理HTTPS证书问题（本地测试场景） #

如果你的Node.js服务用的是自签名HTTPS证书，Java默认会拒绝信任这类证书，导致XHR轮询或WebSocket连接失败。可以临时禁用证书验证（仅用于测试环境，生产环境请配置合法证书）：

// 添加一个创建不安全SSL上下文的工具方法
private SSLContext createInsecureSslContext() throws Exception {
    SSLContext sslContext = SSLContext.getInstance("TLS");
    sslContext.init(null, new TrustManager[]{new X509TrustManager() {
        @Override
        public void checkClientTrusted(X509Certificate[] chain, String authType) {}
        @Override
        public void checkServerTrusted(X509Certificate[] chain, String authType) {}
        @Override
        public X509Certificate[] getAcceptedIssuers() { return new X509Certificate[0]; }
    }}, new SecureRandom());
    return sslContext;
}

// 在Options中配置该SSL上下文
IO.Options options = IO.Options.builder()
        .setPath("/socket.io")
        .setAuth(singletonMap("token","abcd"))
        .setSslContext(createInsecureSslContext())
        .build();

3. 检查Node.js服务端的CORS配置 #

确保服务端允许Spring Boot应用的请求来源，并且支持携带认证信息。修改Node.js服务端的Socket.IO配置：

const io = require('socket.io')(server, {
  cors: {
    origin: "http://localhost:8080", // 替换为你的Spring Boot应用端口/域名
    credentials: true,
    methods: ["GET", "POST"]
  }
});

4. 验证传输方式兼容性 #

如果指定WebSocket传输仍报错，检查服务端是否启用了WebSocket支持，同时可以尝试同时启用轮询和WebSocket传输（让客户端自动协商）：

options.setTransports(new String[]{"polling", "websocket"});

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