Flutter应用如何连接WebSocket？ws协议连接报错该如何处理

你遇到的报错本质是通信栈混用、URL格式不符合底层原生解析规则，和WebSocket本身的连通性没有关系：

• 从异常栈io.socket.client.Url.parse可以确认，当前触发解析逻辑的是打包到Android端的Java原生Socket.IO客户端实现，这类原生实现的URL解析器只接受http:///https://格式的地址，不认识裸ws://协议头，所以直接抛出unknown protocol: ws的MalformedURLException。
• 前置提示socket: ws://project.greatwisher.com:9006/ is not initialized是连锁反应：因为URL解析失败，客户端实例没有完成初始化流程，后续调用连接方法时自然会抛出未处理异常。
• 之前更换多套依赖仍未解决，核心原因是混用了不同层级的Socket实现：比如同时集成了Dart层的WebSocket通道、又引入了原生Socket.IO SDK，调用时跨栈传递参数，导致不符合规则的ws地址传到了原生解析层。

Flutter生态下的Socket/WebSocket实现本质分两类，底层逻辑差异很大，不能混用：

• 纯Dart层实现：完全由Dart runtime处理连接逻辑，通过平台通道直接对接系统的WebSocket能力，没有独立的URL解析规则，天然兼容ws:///wss://协议头，不会触发Java层的MalformedURLException。
• 跨平台Socket.IO封装实现：是对各平台原生Socket.IO SDK的薄封装，所有连接逻辑最终会透传到原生端执行，对地址格式有强制要求，必须传入http/https开头的服务端地址，由客户端内部自动完成WebSocket协议升级。

根据你使用的实现栈，选择对应写法即可：

纯Dart WebSocket实现（推荐，适配纯WS服务端） #

适合服务端是独立WebSocket服务、没有集成Socket.IO协议的场景：

1. 引入对应依赖：web_socket_channel: ^2.4.5
2. 连接逻辑代码示例

import 'package:web_socket_channel/web_socket_channel.dart';

// 直接传入ws/wss格式地址即可，无额外格式要求
final wsChannel = WebSocketChannel.connect(
  Uri.parse('ws://project.greatwisher.com:9006'),
);

// 订阅服务端推送消息
wsChannel.stream.listen(
  (res) => print('收到服务端消息：$res'),
  onError: (err) => print('连接异常：$err'),
  onDone: () => print('连接已关闭'),
);

// 向服务端发送消息
wsChannel.sink.add('测试连接消息');

Socket.IO封装实现（适配已部署Socket.IO协议的服务端） #

适合服务端运行Socket.IO服务的场景：

1. 移除所有冗余的原生Socket.IO集成，仅保留Dart层的socket_io_client依赖，避免跨栈解析冲突
2. 连接地址必须调整格式，去掉ws协议头，替换为http开头的地址

import 'package:socket_io_client/socket_io_client.dart' as IO;

// 错误写法（会触发当前的MalformedURLException）
// final socket = IO.io('ws://project.greatwisher.com:9006', ...);

// 正确写法
final socket = IO.io(
  'http://project.greatwisher.com:9006',
  IO.OptionBuilder()
    // 强制走WebSocket通道，关闭轮询降级
    .setTransports(['websocket'])
    // 关闭自动连接，手动触发初始化
    .disableAutoConnect()
    .build(),
);

// 手动触发连接流程
socket.connect();
socket.onConnect((_) => print('Socket.IO连接成功'));
socket.onDisconnect((_) => print('连接已断开'));

• 若使用http明文地址连接，需要在Android端的AndroidManifest.xml中开启明文流量允许，否则连接会被系统网络安全策略拦截
• 不要混用不同Socket库的通道实例：用web_socket_channel建立的连接，不要调用socket_io_client的方法发送消息，否则会因为通道未完成初始化触发is not initialized提示
• 确认服务端协议类型：如果服务端是纯WebSocket服务、不响应HTTP握手请求，就不要使用Socket.IO客户端连接，直接使用纯Dart层WebSocket通道实现即可

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