如何通过SSHJ SshClient检测SSH连接超时

针对你遇到的SSHJ连接因闲置触发服务器auto-logout但disconnectListener未触发的问题，以下是几种可行的检测与处理方案：

1. 配置KeepAlive心跳机制主动探测 #

服务器端的auto-logout通常是静默断开TCP连接，而非发送标准SSH断开包，这会导致disconnectListener无法捕获。通过配置SSHJ的KeepAlive定期发送心跳，能在连接断开时及时捕获异常：

SshClient sshClient = SshClient.createDefault();
// 配置心跳参数：每60秒发送一次，连续3次失败判定连接断开
sshClient.getKeepAlive().setKeepAliveInterval(60);
sshClient.getKeepAlive().setMaxKeepAliveFailures(3);
sshClient.getKeepAlive().setKeepAliveProvider((session) -> {
    try {
        // 发送SSH心跳包
        session.sendKeepAlive();
    } catch (IOException e) {
        // 心跳失败，触发超时处理逻辑
        handleAutoLogout();
        throw e;
    }
});

后续执行SSH操作（如命令执行、数据读写）时，若捕获到ConnectionLostException或IOException，即可判定为连接因超时断开，执行对应处理。

2. 监听Transport的异常事件 #

替换或补充disconnectListener，使用TransportExceptionListener捕获连接异常，这类异常通常会在TCP连接被服务器强制断开时触发：

sshClient.getTransport().addExceptionListener((transport, throwable) -> {
    // 根据服务器抛出的超时信息匹配（可根据实际异常消息调整）
    if (throwable.getMessage() != null && throwable.getMessage().contains("timed out waiting for input: auto-logout")) {
        handleAutoLogout();
    }
});

注意：不同服务器的超时异常消息可能略有差异，需根据实际场景调整匹配逻辑。

3. 为Session或Command设置I/O超时 #

在创建Session或执行Command时直接设置超时时间，当指定时间内无I/O操作时会主动抛出TimeoutException，便于捕获处理：

// 为Session设置全局超时
Session session = sshClient.startSession();
session.setTimeout(300000); // 5分钟无操作超时

// 或为单个Command设置超时
Command cmd = session.exec("your-command");
cmd.setTimeout(300000);

捕获TimeoutException后即可执行优雅的超时处理逻辑。

补充说明 #

服务器端的auto-logout大多是直接关闭TCP连接，而非通过SSH协议的断开流程，因此disconnectListener无法触发。结合KeepAlive主动探测和异常监听，是覆盖这类场景最可靠的方式。

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