GreenMail使用IMAPS协议连接时出现SSLHandshakeException求助

以下是几个针对性的解决方案，按优先级排序：

1. 让Java Mail信任GreenMail的自签名证书 #

GreenMail默认使用自签名SSL证书，Java 11的默认信任库不会信任这类证书，这是握手失败的最常见原因。无需全局修改SocketFactory，直接在Java Mail的配置中添加信任设置：

Properties mailProps = new Properties();
mailProps.put("mail.imaps.host", "localhost");
mailProps.put("mail.imaps.port", String.valueOf(greenMail.getImaps().getPort()));
// 信任所有服务器证书（仅测试环境使用，生产环境请勿这么做）
mailProps.put("mail.imaps.ssl.trust", "*");

// 初始化会话并连接
Session session = Session.getInstance(mailProps);
Store imapsStore = session.getStore("imaps");
imapsStore.connect("test-user", "test-pass");

如果需要更安全的方式，可以提取GreenMail的证书并导入到Java的信任库中，但测试环境用*足够。

2. 确保GreenMail正确启动IMAPS服务 #

确认你的GreenMail实例是基于IMAPS配置启动的，而非仅IMAP：

// 使用GreenMail内置的测试IMAPS配置
GreenMail greenMail = new GreenMail(ServerSetupTest.IMAPS);
greenMail.start();

// 或者自定义IMAPS端口（比如默认993）
ServerSetup customImapsSetup = new ServerSetup(993, null, "imaps");
GreenMail greenMail = new GreenMail(customImapsSetup);
greenMail.start();

如果启动时没指定IMAPS，GreenMail不会开启对应的SSL端口，自然无法通过IMAPS连接。

3. 修复全局SSL上下文配置（替代方案） #

如果你一定要用全局SSL设置，不要直接修改ssl.SocketFactory.provider，而是正确初始化SSL上下文并设为默认：

try {
    // 创建信任所有证书的TrustManager（仅测试用）
    TrustManager[] trustAll = new TrustManager[]{
        new X509TrustManager() {
            @Override
            public X509Certificate[] getAcceptedIssuers() { return new X509Certificate[0]; }
            @Override
            public void checkClientTrusted(X509Certificate[] certs, String authType) {}
            @Override
            public void checkServerTrusted(X509Certificate[] certs, String authType) {}
        }
    };

    SSLContext sslContext = SSLContext.getInstance("TLSv1.2");
    sslContext.init(null, trustAll, new SecureRandom());
    SSLContext.setDefault(sslContext);
} catch (NoSuchAlgorithmException | KeyManagementException e) {
    throw new RuntimeException(e);
}

这种方式会让整个JVM信任所有证书，适合测试场景，但不要在生产环境使用。

4. 强制指定TLS协议版本 #

Java 11默认的TLS版本可能和GreenMail的默认配置不兼容，可以在Java Mail属性中指定协议：

mailProps.put("mail.imaps.ssl.protocols", "TLSv1.2");

GreenMail多数版本默认使用TLS 1.2，指定这个版本可以避免协议协商失败。

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