Docker部署的Slack Socket Mode应用自动断连重连问题排查

问题场景 #

使用Bolt框架通过Socket Mode连接Slack的JavaScript应用部署在Docker容器中，运行一段时间后连接会自行断开并重新连接，仅输出重连日志无错误信息，但断连期间会丢失部分事件。

日志信息 #

[INFO] socket-mode:SocketModeClient:0 Reconnecting to Slack ...
[INFO] socket-mode:SocketModeClient:0 Going to establish a new connection to Slack
[INFO] socket-mode:SocketModeClient:0 Now connected to Slack

应用代码（index.js） #

const app = new Slack.App({
    token: ,
    signingSecret: ,
    socketMode: true,
    appToken: ,
    extendedErrorHandler: true,

});
(async () => {
    // Start your app
    await app.start(3000);
    console.log('⚡️ Bolt app is running!');
})();

依赖配置（package.json） #

"dependencies": {
    "@slack/bolt": "3.5",
    "@slack/rtm-api": "^6.1.0",
    "@slack/socket-mode": "^1.3.2",
    "@slack/web-api": "^6.8.1",
    "node-fetch": "^3.3.1"
  }

可能的断连原因及解决方法 #

1. 版本兼容性问题 #

当前使用的@slack/bolt 3.5版本较旧，和依赖的@slack/socket-mode 1.3.2可能存在兼容性问题。Socket Mode在后续版本中修复了不少连接稳定性问题：

• 升级@slack/bolt到最新稳定版，通常bolt会自动管理socket-mode依赖，可直接升级bolt后移除单独的socket-mode依赖声明
• 执行命令：npm update @slack/bolt

2. Docker网络超时限制 #

Docker容器的网络环境可能存在默认的超时设置，导致长连接被自动断开：

• 检查Docker容器的网络配置，确保没有强制断开空闲连接的规则
• 启动容器时添加参数调整TCP keepalive设置，示例：docker run --sysctl net.ipv4.tcp_keepalive_time=600 --sysctl net.ipv4.tcp_keepalive_intvl=30 --sysctl net.ipv4.tcp_keepalive_probes=10 [镜像名]

3. Slack服务器端的连接回收 #

Slack会定期回收空闲的Socket Mode连接，若应用长时间没有事件交互，可能触发断连：

• 在应用中添加心跳机制，定期发送简单的API请求保持连接活跃，示例代码：

// 每5分钟发送一次心跳请求
setInterval(async () => {
  try {
    await app.client.auth.test({});
  } catch (err) {
    console.error('心跳请求失败:', err);
  }
}, 300000);

4. 重连策略配置不足 #

当前代码未配置重连相关参数，默认重连逻辑可能不够健壮：

• 在Slack App初始化时添加重连策略与TCP keepalive配置，示例：

const app = new Slack.App({
    token: process.env.SLACK_BOT_TOKEN,
    signingSecret: process.env.SLACK_SIGNING_SECRET,
    socketMode: true,
    appToken: process.env.SLACK_APP_TOKEN,
    extendedErrorHandler: true,
    socketModeOptions: {
        clientOptions: {
            // 调整重连间隔，避免频繁重连
            retryConfig: {
                maxRetryCount: 10,
                retryDelay: (attempt) => Math.min(1000 * Math.pow(2, attempt), 30000),
            },
            // 启用TCP keepalive
            keepAlive: true,
        },
    },
});

5. 容器资源限制 #

Docker容器的内存或CPU资源不足，可能导致Node.js进程出现隐性错误，进而触发连接断开：

• 调整Docker容器的资源配额，比如增加内存限制：docker run -m 1g [镜像名]
• 通过docker stats监控容器内的CPU、内存占用情况

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