Socket.io的path参数末尾自动追加斜杠导致连接失败如何配置解决

云上老周

2026-9-29

问题原因

Socket.io 的path配置项内置默认逻辑，会自动在路径末尾追加斜杠，目前无官方配置项可直接关闭该行为，路径拼接异常由此逻辑导致。

额外注意：配置中的autoconnect为全小写，官方对应配置项为驼峰格式autoConnect，全小写配置会被忽略，可能导致此前的配置调整不生效。

解决方案

方案1：服务端适配（优先推荐）

若服务端可调整，选择该方案成本最低：

将服务端Socket.io挂载路径调整为/getTxInfo/，直接兼容前端自动追加的斜杠
或在服务端路由/反向代理层配置忽略路径末尾斜杠差异，如Nginx可配置merge_slashes on;，Node.js Express框架可开启strict routing适配，也可配置重写规则将/getTxInfo/?xxx请求自动转发到/getTxInfo?xxx

方案2：前端手动修改路径

若无法调整服务端，可关闭自动连接，手动移除路径末尾的斜杠后再发起连接，示例代码如下：

var socket = io('https://domain:1255', {
    path: '/getTxInfo',
    transports: ['websocket'],
    autoConnect: false, // 关闭默认自动连接，待路径调整完成后手动触发
    query: {
      txId: this.tx.txid,
      secret: this.tx.secret
    }
});
// 移除路径末尾自动追加的斜杠
socket.io.opts.path = socket.io.opts.path.replace(/\/$/, '');
// 手动发起连接
socket.connect();