Expo React Native iOS模拟器下socket.io持续重连无法连接问题求助

问题现象对应根因 #

结合描述的症状：RN端仅打印open日志、无connect回调触发，但Nest后端持续打印携带不同id的新连接日志，可以直接排除网络完全不通的情况，核心根因集中在三点：

• socket.io 客户端与服务端协议版本不匹配。这是最高概率的触发原因：当两端socket.io大版本不一致时，TCP层连接可以正常建立，但应用层握手数据包格式无法互通，客户端永远等不到服务端的握手响应，就会按照内置的重试逻辑反复断连重连，最终表现就是后端持续收到不同id的新连接请求，客户端侧始终触发不了connect事件。
• WebSocket握手环节的CORS校验拦截。NestJS 内置的WebSocket网关默认不会对非浏览器来源的请求做自动放行，Vue端能正常连接是因为开发环境下Vue的请求来源在网关的默认白名单内，但Expo客户端运行时的请求Origin是exp://协议开头，不在默认放行范围内，握手时会被服务端直接截断，客户端收不到合法响应就会反复重试，和版本不匹配的现象完全一致。
• iOS模拟器下的地址配置错误。iOS模拟器运行时的localhost/127.0.0.1指向模拟器自身的网络环境，不是运行Nest服务的本地电脑，如果socketUrl配置错了地址，本来应该触发连接超时，但因为socket.io的重连机制，也会出现反复发起连接的异常表现。

可直接落地的修复步骤 #

1. 对齐两端socket.io协议版本
   • 先在Nest服务端项目中执行npm ls socket.io，确认服务端依赖的socket.io核心大版本（比如v4.x版本必须搭配同大版本的socket.io-client，v3.x同理，跨大版本会直接出现握手失败）
   • 在Expo项目中安装匹配大版本的客户端依赖，不要盲目安装最新版避免协议跳转
   • 初始化socket实例时强制使用纯WebSocket传输，跳过移动端兼容性较差的长轮询握手环节：

     const socket = io(socketUrl, {
       transports: ['websocket'],
       withCredentials: true,
     })
     

2. 修正iOS模拟器的网络连通配置
   • 不要用localhost/127.0.0.1作为socketUrl，替换为运行Nest服务的电脑在局域网下的实际IPv4地址
   • 确认Nest服务启动时监听的地址是0.0.0.0，而不是仅允许本地访问的127.0.0.1，否则模拟器的请求会被直接拒绝
3. 给Nest WebSocket网关补全CORS放行规则
   修改网关装饰器参数，放开对Expo来源的请求限制：

   @WebSocketGateway({
     cors: {
       origin: '*', // 生产环境需替换为实际的合法来源，开发阶段可临时配置为*快速验证
       credentials: true,
     },
   })
   

4. 补全全流程日志定位卡壳点
   在socket实例上添加全链路事件监听，快速定位握手失败的具体环节：

   socket.on('connect_error', (err) => console.log('握手错误', err))
   socket.on('disconnect', (reason) => console.log('断开原因', reason))
   socket.io.on('reconnect_attempt', (attemptNum) => console.log('发起第N次重连', attemptNum))
   

关于“是否是iOS模拟器专属问题”的说明 #

这类问题不是iOS模拟器独有的。安卓模拟器、真机环境下只要存在版本不匹配、CORS拦截、地址配置错误的问题，都会出现完全相同的表现。只是iOS模拟器的网络沙箱对请求来源、访问地址的校验更严格，触发这类问题的概率比其他移动端环境更高，问题本身和iOS系统没有专属关联。 #

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