Cordova集成Socket.io无法上传文件至服务器问题求助

1. 先确认Socket连接是否正常 #

很多时候文件无响应是因为连接根本没建立，先做基础校验：

• 客户端添加连接状态监听：

  const socket = io('http://你的服务器地址', { transports: ['websocket'] });
  socket.on('connect', () => console.log('Socket已连接'));
  socket.on('connect_error', err => console.error('连接失败:', err));
  socket.on('disconnect', reason => console.log('断开连接:', reason));
  

• 服务器端添加连接日志：

  const io = require('socket.io')(server, { transports: ['websocket'] });
  io.on('connection', socket => console.log('新客户端连接:', socket.id));
  

• 检查Cordova权限：在config.xml中添加对应服务器的访问权限，比如<access origin="http://你的服务器地址" />；如果是Android 9+且用HTTP协议，需要在AndroidManifest.xml的<application>标签里加android:usesCleartextTraffic="true"。

2. 修正文件数据的处理方式 #

直接传递File对象可能导致序列化失败，需转成二进制格式传输：

• 客户端读取文件为ArrayBuffer后发送：

  function sendFile(file) {
    const reader = new FileReader();
    reader.onload = (e) => {
      socket.emit('upload-file', {
        filename: file.name,
        data: e.target.result
      }, (res) => {
        console.log('服务器回执:', res); // 用回调确认发送状态
      });
    };
    reader.readAsArrayBuffer(file);
  }
  

• 服务器端监听事件并处理二进制数据：

  io.on('connection', socket => {
    socket.on('upload-file', (data, callback) => {
      console.log('收到文件:', data.filename);
      // 将ArrayBuffer转成Buffer保存
      const fileBuffer = Buffer.from(data.data);
      // 这里写文件保存逻辑
      callback({ status: 'success', msg: '文件接收完成' });
    });
    socket.on('error', err => console.error('客户端Socket错误:', err));
  });
  

3. 启用二进制支持与调整传输配置 #

socket.io v2.x需确保二进制传输开启，同时强制使用WebSocket避免轮询问题：

• 客户端初始化配置：

  const socket = io('http://你的服务器地址', {
    transports: ['websocket'],
    binary: true,
    maxHttpBufferSize: 1024 * 1024 * 100 // 100MB，根据文件大小调整
  });
  

• 服务器端配置：

  const io = require('socket.io')(server, {
    transports: ['websocket'],
    binary: true,
    maxHttpBufferSize: 1024 * 1024 * 100
  });
  

4. 排查版本兼容性 #

虽然v2.5.0客户端和v2.4.0服务器理论兼容，但建议将服务器端socket.io升级到v2.5.0，消除版本差异可能带来的静默问题。

5. 捕获所有静默错误 #

确保两端都监听错误事件，避免错误被忽略：

• 客户端额外添加：

  socket.on('error', err => console.error('Socket异常:', err));
  

• 服务器端在连接实例上添加错误监听：

  io.on('connection', socket => {
    socket.on('error', err => console.error('客户端Socket错误:', err));
  });
  

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