如何通过JSch捕获Linux账户锁定错误？

好问题！我之前也碰到过类似的情况——JSch默认的认证逻辑确实会把所有密码相关的失败都笼统地抛出Auth fail异常，完全忽略了SSH服务器返回的具体锁定提示。不过我们可以通过自定义UserInfo接口的实现来捕获这段关键信息，精准识别账户锁定状态。

核心原理 #

当Linux账户因登录失败次数过多被锁定时，OpenSSH服务器会在密码输入提示符前附加一段提示文本（比如Account locked due to 6 failed logins Password:）。JSch的UserInfo接口提供了promptPassword回调方法，这个方法的参数就是服务器发送的完整密码提示信息——我们可以利用这一点来检测账户是否被锁定。

具体实现步骤 #

1. 自定义UserInfo类 #

重写promptPassword方法，检查传入的提示信息是否包含账户锁定的关键词（比如Account locked），同时记录锁定状态：

import com.jcraft.jsch.UserInfo;

public class LockAwareUserInfo implements UserInfo {
    private final String password;
    private boolean accountLocked = false;
    private String passwordPromptMessage;

    public LockAwareUserInfo(String password) {
        this.password = password;
    }

    public boolean isAccountLocked() {
        return accountLocked;
    }

    public String getPasswordPromptMessage() {
        return passwordPromptMessage;
    }

    @Override
    public String getPassword() {
        return password;
    }

    @Override
    public boolean promptPassword(String message) {
        this.passwordPromptMessage = message;
        // 检测提示信息中的锁定关键词
        if (message.contains("Account locked")) {
            accountLocked = true;
            return false; // 返回false终止认证流程
        }
        return true;
    }

    // 实现其他必需的接口方法（默认返回空或false即可）
    @Override
    public String getPassphrase() {
        return null;
    }

    @Override
    public boolean promptPassphrase(String message) {
        return false;
    }

    @Override
    public boolean promptYesNo(String message) {
        return false;
    }

    @Override
    public void showMessage(String message) {}
}

2. 使用自定义UserInfo进行认证 #

在创建Session后设置这个自定义UserInfo，连接失败时检查锁定状态：

import com.jcraft.jsch.JSch;
import com.jcraft.jsch.Session;

public class SshLoginTest {
    public static void main(String[] args) {
        String host = "your-linux-host";
        String username = "locked-account";
        String password = "any-password";

        JSch jsch = new JSch();
        try {
            Session session = jsch.getSession(username, host, 22);
            LockAwareUserInfo userInfo = new LockAwareUserInfo(password);
            session.setUserInfo(userInfo);
            
            // 禁用StrictHostKeyChecking避免首次连接的确认提示
            session.setConfig("StrictHostKeyChecking", "no");
            session.connect();
            
            System.out.println("登录成功");
            session.disconnect();
        } catch (Exception e) {
            if (e.getMessage().contains("Auth fail")) {
                LockAwareUserInfo userInfo = (LockAwareUserInfo) ((Session) e.getSource()).getUserInfo();
                if (userInfo.isAccountLocked()) {
                    System.out.println("检测到账户锁定：" + userInfo.getPasswordPromptMessage());
                    // 这里可以添加自定义的锁定处理逻辑，比如告警、记录日志等
                } else {
                    System.out.println("认证失败：密码错误或其他非锁定原因");
                }
            } else {
                System.out.println("连接异常：" + e.getMessage());
            }
        }
    }
}

额外优化 #

• 不同Linux发行版的SSH服务器可能会有略微不同的锁定提示文本，你可以根据实际环境调整关键词（比如有的可能用Account is locked）。
• 如果需要提取具体的失败登录次数，可以用正则表达式匹配提示信息，例如：

import java.util.regex.Matcher;
import java.util.regex.Pattern;

// 在promptPassword方法中添加
Pattern pattern = Pattern.compile("Account locked due to (\\d+) failed logins");
Matcher matcher = pattern.matcher(message);
if (matcher.find()) {
    int failedAttempts = Integer.parseInt(matcher.group(1));
    System.out.println("失败登录次数：" + failedAttempts);
}

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