如何解决Node.js使用Bull库时出现的read ECONNRESET报错

这两个报错属于关联问题：

• ECONNRESET 错误是Bull依赖的ioredis客户端与Redis服务器的TCP连接被意外中断导致，通常是网络波动、Redis服务异常、空闲连接被主动回收触发
• MaxRetriesPerRequestError 是连接中断后，ioredis默认自动重试请求，达到默认的20次重试上限后抛出的错误

• 检查Redis服务运行状态：确认Redis进程是否正常运行，是否存在OOM被系统终止、服务崩溃的情况，查看Redis服务日志是否有异常记录
• 检查网络连通性：如果使用远程Redis服务，确认Node服务所在服务器与Redis之间的网络是否通畅，安全组、防火墙规则是否放行Redis端口，是否存在网络带宽超限、连接数超限的情况
• 检查Redis配置：确认Redis是否配置了timeout参数自动断开空闲连接，多数云厂商托管的Redis服务会默认设置300秒的空闲连接超时，会主动断开长时间无请求的连接
• 检查连接参数：确认process.env.REDIS_URL配置正确，包含正确的密码、数据库编号，如果使用加密连接的Redis服务，确认是否缺少TLS相关配置

1. 基础问题修复

• 若Redis服务异常，先恢复Redis服务，建议配置Redis主从、哨兵模式提高可用性，避免单点故障
• 若存在网络问题，建议将Node服务与Redis部署在同一内网环境，降低网络波动概率，调整安全组、防火墙规则放行对应端口
• 若为空闲连接超时回收导致的断开，可将Redis的timeout参数设置为0，或者在Bull配置中添加心跳保活参数

2. 代码配置优化
   修改队列初始化代码，补充ioredis相关配置，优化连接与重试策略：

const imageQueue = new Bull("imageQueue", process.env.REDIS_URL, {
  redis: {
    // 开启连接就绪检查
    enableReadyCheck: true,
    // 每10秒发送心跳包保活，避免空闲连接被回收
    keepAlive: 10000,
    // 调整单次请求最大重试次数，可根据业务需求修改
    maxRetriesPerRequest: 50,
    // 自定义重试策略，重试间隔递增，最大2秒一次
    retryStrategy(times) {
      return Math.min(times * 50, 2000);
    },
    // 如果使用需要TLS加密的云Redis服务，开启下方配置
    // tls: {
    //   rejectUnauthorized: false
    // }
  },
  // 配置队列默认任务重试规则
  defaultJobOptions: {
    attempts: 3,
    backoff: {
      type: 'exponential',
      delay: 1000
    }
  }
});

如果使用Redis集群，需额外配置集群节点参数，不要直接传入单个Redis连接URL。

3. 增加错误监听
   添加队列全局错误监听，避免未捕获异常导致进程退出：

// 监听队列全局错误
imageQueue.on('error', (err) => {
  console.error('队列运行异常：', err);
});
// 监听任务执行失败事件
imageQueue.on('failed', (job, err) => {
  console.error(`任务ID ${job.id} 执行失败：`, err);
});

内容的提问来源于stack exchange，提问作者putu eka mulyana