@socket.io/redis-adapter无法捕获ECONNRESET错误致应用崩溃如何解决

问题根因定位 #

你遇到的未捕获错误核心原因是**@socket.io/redis-adapter 7.x版本中，每个Socket.IO命名空间会独立创建Adapter实例，你仅为根命名空间/的Adapter绑定了错误监听，其他命名空间（比如代码中用到的/user）的Adapter触发error事件时没有对应监听器，就会直接抛出导致进程崩溃**。

修复方案 #

1. 为所有命名空间统一绑定Adapter错误监听
   利用Socket.IO的new_namespace事件，所有动态/静态创建的命名空间都会触发该事件，在回调中为每个命名空间的Adapter绑定错误处理：

io.on('new_namespace', (namespace) => {
    namespace.adapter.on('error', (err) => {
        debug(`命名空间${namespace.name}的Redis Adapter错误：%O`, err)
    })
})

你之前只绑定了/命名空间的错误监听，漏掉了其他自定义命名空间，这是最直接的崩溃原因。

2. 调整错误监听的绑定顺序
   建议先完成Adapter的错误监听配置，再挂载到IO实例上，避免挂载后、监听绑定前的短时间内出现错误无法捕获的极端情况。

3. 版本升级
   你使用的7.0.0版本属于@socket.io/redis-adapter 7.x的早期版本，存在已知的错误事件重复冒泡问题，可升级到7.2.0及以上的稳定小版本，该版本已修复错误事件异常抛出的相关bug。

错误原因说明 #

你遇到的ECONNRESET错误和Redis服务本身无关，是中间网络设备（如防火墙、负载均衡）的TCP空闲连接超时机制导致的：Redis pub/sub的长连接如果长时间没有消息传输，中间设备会主动断开空闲连接，就会触发该错误。其他共用Redis的服务没有出现该问题，是因为它们的连接有更频繁的请求交互，不会触发空闲超时。
你现有的5分钟心跳机制可以调整到更短的间隔（比如1分钟），适配中间设备的超时规则，减少连接被断开的概率。

兜底方案 #

可以添加全局异常捕获逻辑，避免偶发未处理错误直接导致进程崩溃：

// 兜底捕获未处理的同步异常
process.on('uncaughtException', (err) => {
    debug('未捕获全局异常：%O', err)
    // 可在此处添加告警逻辑，非致命错误不需要退出进程
})
// 兜底捕获未处理的Promise异常
process.on('unhandledRejection', (reason, promise) => {
    debug('未处理Promise拒绝：%O，来源%O', reason, promise)
})

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