Java收私有邮箱邮件遇SSLHandshakeException问题求助

我正在开发一款仅接收私有邮箱（非Gmail）邮件的Java应用，但始终遭遇连接失败或SSL握手类问题，最近出现的错误为：

Javax.net.ssl.SSLHandshakeException: Remote host terminated the handshake

我的Java类代码如下：

import java.util.Properties;
import javax.mail.Folder;
import javax.mail.Message;
import javax.mail.MessagingException;
import javax.mail.NoSuchProviderException;
import javax.mail.Session;
import javax.mail.Store;

public class CheckingMail {

  public static void check(String host, String storeType, String user,
                           String password)
  {
    try {

      //create properties field
      Properties properties = new Properties();

      properties.put("mail.pop3.host", host);
      properties.put("mail.pop3.port", "995");
      properties.put("mail.pop3s.ssl.protocols", "TLSv1.2");
      properties.setProperty("mail.pop3.ssl.trust", "*"); // Trust all Servers
      properties.setProperty("mail.pop3.ssl.trust", "private hostname"); // Trust all Servers
      Session emailSession = Session.getDefaultInstance(properties);

      //create the POP3 store object and connect with the pop server
      Store store = emailSession.getStore("pop3s");

      store.connect(host, user, password);

      //create the folder object and open it
      Folder emailFolder = store.getFolder("INBOX");
      emailFolder.open(Folder.READ_ONLY);

      // retrieve the messages from the folder in an array and print it
      Message[] messages = emailFolder.getMessages();
      System.out.println("messages.length---" + messages.length);

      for (int i = 0, n = messages.length; i < n; i++) {
        Message message = messages[i];
        System.out.println("---------------------------------");
        System.out.println("Email Number " + (i + 1));
        System.out.println("Subject: " + message.getSubject());
        System.out.println("From: " + message.getFrom()[0]);
        System.out.println("Text: " + message.getContent().toString());

      }

      //close the store and folder objects
      emailFolder.close(false);
      store.close();

    } catch (NoSuchProviderException e) {
      e.printStackTrace();
    } catch (MessagingException e) {
      e.printStackTrace();
    } catch (Exception e) {
      e.printStackTrace();
    }
  }

  public static void main(String[] args) {

    String host = "private host name";// change accordingly
    String mailStoreType = "pop3";
    String username = "my email";// change accordingly
    String password = "my password";// change accordingly


    check(host, mailStoreType, username, password);

  }

}

解决方案 #

• 修正属性配置冲突
  代码中重复设置了mail.pop3.ssl.trust，第二次赋值会覆盖第一次的*，若私有邮箱证书不在系统信任列表中，会直接导致握手失败。保留其中一个配置即可：

  • 测试阶段可保留"*"临时信任所有证书（生产环境不建议）；
  • 生产环境请确保填写的private hostname与邮箱服务器证书中的域名完全匹配。

• 统一POP3s协议属性前缀
  你使用的是加密POP3协议（pop3s），但部分属性用了mail.pop3.xxx前缀，需统一改为mail.pop3s.xxx才能生效：

  properties.put("mail.pop3s.host", host);
  properties.put("mail.pop3s.port", "995");
  properties.put("mail.pop3s.ssl.protocols", "TLSv1.2");
  properties.setProperty("mail.pop3s.ssl.trust", "*");
  

• 改用独立Session实例
  Session.getDefaultInstance会复用全局默认会话，可能携带无关配置干扰连接。改用Session.getInstance创建独立会话：

  Session emailSession = Session.getInstance(properties);
  

• 启用SSL调试日志定位问题
  启动JVM时添加以下参数，输出完整的SSL握手日志，可精准定位是证书不匹配、协议版本不兼容还是加密套件问题：

  -Djavax.net.debug=ssl,handshake
  

• 验证服务器配置与账号权限

  • 确认私有邮箱服务器支持TLSv1.2协议，若服务器仅支持老旧协议（如TLSv1.0），需调整mail.pop3s.ssl.protocols的值；
  • 检查邮箱账号是否开启了POP3服务权限，部分私有邮箱默认关闭该功能；
  • 确认host、username、password完全正确，部分邮箱要求使用完整邮箱地址作为用户名。

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