部署Spring Boot到Tomcat时SSH隧道连接远程数据库失败求助

首先咱们得抓准核心矛盾：内嵌Tomcat里SSH连接能正常跑，但换到独立Tomcat就不行，大概率是SSH隧道的初始化时机不对，或者独立Tomcat的类加载、安全策略限制了SSH连接的创建。下面是具体的排查和解决步骤：

1. 调整SSH隧道的初始化时机 #

你之前用contextListener创建SSH连接，在独立Tomcat环境里，这个Listener的执行时机可能早于Spring Boot上下文的初始化——导致数据库连接池启动时，SSH隧道还没建好，自然连不上远程库。

建议把SSH连接的初始化逻辑移到Spring的ApplicationListener里，监听ApplicationReadyEvent事件，确保Spring上下文完全准备好后再建立隧道：

@Component
public class SshTunnelInitializer implements ApplicationListener<ApplicationReadyEvent> {

    @Value("${ssh.host}")
    private String sshHost;
    @Value("${ssh.port}")
    private int sshPort;
    @Value("${ssh.username}")
    private String sshUsername;
    @Value("${ssh.password}")
    private String sshPassword;
    @Value("${db.local.port}")
    private int localPort;
    @Value("${db.remote.host}")
    private String remoteDbHost;
    @Value("${db.remote.port}")
    private int remoteDbPort;

    private Session sshSession;

    @Override
    public void onApplicationEvent(ApplicationReadyEvent event) {
        try {
            JSch jsch = new JSch();
            sshSession = jsch.getSession(sshUsername, sshHost, sshPort);
            sshSession.setPassword(sshPassword);
            // 生产环境建议配置主机密钥，这里先跳过校验方便测试
            sshSession.setConfig("StrictHostKeyChecking", "no");
            sshSession.connect();
            // 建立本地端口到远程数据库的转发
            sshSession.setPortForwardingL(localPort, remoteDbHost, remoteDbPort);
            System.out.println("SSH隧道已成功建立");
        } catch (JSchException e) {
            throw new RuntimeException("初始化SSH隧道失败", e);
        }
    }

    @PreDestroy
    public void destroy() {
        if (sshSession != null && sshSession.isConnected()) {
            sshSession.disconnect();
            System.out.println("SSH隧道已关闭");
        }
    }
}

这样能保证数据库连接池启动前，SSH隧道已经稳稳建立好了。

2. 检查独立Tomcat的安全策略 #

独立Tomcat默认的安全策略可能会限制Socket连接（SSH需要创建Socket），你可以修改TOMCAT_HOME/conf/catalina.policy文件，给你的应用添加必要的权限：

grant codeBase "file:${catalina.base}/webapps/你的应用名/-" {
    permission java.net.SocketPermission "*:22", "connect,resolve";
    permission java.net.SocketPermission "localhost:你的本地转发端口", "listen,accept,connect,resolve";
};

注意把22换成你的实际SSH端口，你的本地转发端口换成你配置的db.local.port值。

3. 验证数据库连接配置 #

确保你的数据库URL是指向本地转发端口的，比如：

spring.datasource.url=jdbc:mysql://localhost:3307/你的数据库名?useSSL=false&serverTimezone=UTC

这里的3307要和SSH初始化时设置的localPort完全一致。

4. 扒日志找具体原因 #

去TOMCAT_HOME/logs/localhost.log或者你的应用专属日志里，找连接失败的具体异常信息：

• 如果是SSH连接失败，可能是Tomcat所在机器无法访问远程SSH服务器（比如防火墙拦截）；
• 如果是本地端口连不上，那就是SSH隧道根本没建好，回到第一步检查初始化逻辑。

5. 避免端口冲突 #

确认你配置的本地转发端口（比如3307）在Tomcat所在机器上没被其他进程占用：

• Windows用netstat -ano | findstr 3307；
• Linux用lsof -i :3307。

按这些步骤排查下来，应该能解决独立Tomcat下SSH隧道连接失败的问题。

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