Android Java中PLAIN认证+IMAP over SSL邮件服务器连接失败

问题场景 #

我尝试使用imap协议通过SSL加密，采用PLAIN认证方式连接邮件服务器，相关代码如下：

Properties props = new Properties();
props.put("mail.store.protocol", "imaps");
props.put("mail.imap.host", "imap.***my-server-domain***");
props.put("mail.imap.port", "993");
props.put("mail.imap.ssl.enable", "true");

final Authenticator authenticator = new Authenticator() {
    @Override
    protected PasswordAuthentication getPasswordAuthentication() {
        return new PasswordAuthentication(
                login,
                password
        );
    }
};
Session session = Session.getInstance(props, authenticator);
Store store = null;
try {
    store = session.getStore("imap");
} catch (NoSuchProviderException e) {
    throw new RuntimeException(e);
}
try {
    store.connect();
} catch (MessagingException e) {
    throw new RuntimeException(e);
}

遇到的错误 #

错误类型1 #

at android.os.StrictMode$AndroidBlockGuardPolicy.onNetwork(StrictMode.java:1667)
at java.net.Inet6AddressImpl.lookupHostByName(Inet6AddressImpl.java:115)
at java.net.Inet6AddressImpl.lookupAllHostAddr(Inet6AddressImpl.java:103)
at java.net.InetAddress.getByName(InetAddress.java:1106)
at jakarta.mail.URLName.getHostAddress(URLName.java:502)
at jakarta.mail.URLName.hashCode(URLName.java:478)
at java.util.Hashtable.get(Hashtable.java:365)
at jakarta.mail.Session.getPasswordAuthentication(Session.java:889)
at jakarta.mail.Service.connect(Service.java:325)
at jakarta.mail.Service.connect(Service.java:222)
at jakarta.mail.Service.connect(Service.java:171)

错误类型2（调整设置后出现） #

at jakarta.mail.Service.connect(Service.java:342)

已尝试的操作 #

• 切换imap/imaps协议
• 调整端口（服务器实际运行在993端口）
• 确认应用已配置网络权限，且网络可用
• 怀疑PLAIN认证方式的配置存在问题

排查与解决方案 #

1. 修复协议与配置不匹配问题 #

代码中设置mail.store.protocol为imaps，但调用session.getStore("imap")获取的是普通IMAP协议的Store，导致配置不生效。需统一协议类型：

// 改为获取imaps协议的Store
store = session.getStore("imaps");

2. 强制指定PLAIN认证方式 #

添加配置强制使用PLAIN认证，避免自动选择不兼容的机制：

// 针对imaps协议的配置
props.put("mail.imaps.auth.mechanisms", "PLAIN");

3. 解决主线程网络操作限制 #

第一个错误栈显示StrictMode拦截了主线程的网络请求，Android不允许在主线程执行网络操作，需将连接逻辑放到子线程：

new Thread(new Runnable() {
    @Override
    public void run() {
        try {
            store.connect();
            // 连接成功后的业务逻辑
        } catch (MessagingException e) {
            e.printStackTrace();
        }
    }
}).start();

4. 补充完整IMAPS配置项 #

使用993端口时推荐用标准IMAPS配置，确保参数对应正确：

Properties props = new Properties();
props.put("mail.store.protocol", "imaps");
props.put("mail.imaps.host", "imap.***my-server-domain***");
props.put("mail.imaps.port", "993");
props.put("mail.imaps.ssl.enable", "true");
props.put("mail.imaps.auth.mechanisms", "PLAIN");
// 测试环境可临时关闭证书验证（生产环境禁用）
// props.put("mail.imaps.ssl.trust", "*");

5. 捕获完整异常信息 #

当前代码仅抛出RuntimeException，建议打印完整异常栈以定位具体问题：

catch (MessagingException e) {
    e.printStackTrace();
    throw new RuntimeException("邮件服务器连接失败: " + e.getMessage(), e);
}

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