使用javax.mail时邮件消息莫名消失的问题排查

问题原因 #

• POP3协议特性：部分邮件服务器会将已通过POP3下载过的邮件从INBOX的POP3可见列表中移除（实际可能移至服务器的“已下载”或归档文件夹），导致二次调用getMessages()时返回的邮件数量减少。
• 硬编码索引风险：直接使用固定索引229访问邮件数组，完全依赖首次运行时的邮件数量，一旦数量变动就会触发数组越界异常。

解决方案 #

1. 替换为IMAP协议（推荐） #

IMAP协议支持与邮件服务器实时同步邮件状态，不会因下载过就隐藏邮件，更适合持续访问同一批邮件的场景。修改代码如下：

public static void receiveEmail(String hst, String stype, String user, String password) {
    try {
        Properties props = new Properties();
        // 切换为IMAPS协议
        props.put("mail.store.protocol", "imaps");
        props.put("mail.imaps.host", hst);
        props.put("mail.imaps.port", "993");
        props.put("mail.imaps.starttls.enable", "true");
        
        // 使用独立Session替代全局共享Session，避免状态冲突
        Session sess = Session.getInstance(props);
        Store st = sess.getStore("imaps");
        st.connect(hst, user, password);
        
        Folder emailFolder = st.getFolder("INBOX");
        emailFolder.open(Folder.READ_ONLY);
        Message[] messages = emailFolder.getMessages();
        
        // 动态获取最后一封邮件，避免硬编码索引
        if(messages.length > 0) {
            Message message = messages[messages.length - 1];
            System.out.println("Welcome To Email");
            System.out.println("Subject: " + message.getSubject());
            System.out.println("From: " + message.getFrom()[0]);
            
            // 兼容非多部分邮件内容，避免强制转换异常
            if(message.getContent() instanceof Multipart) {
                Multipart part = (Multipart) message.getContent();
                MimeBodyPart mimePart = null;
                for (int i = 0; i < part.getCount(); i++) {
                    mimePart = (MimeBodyPart) part.getBodyPart(i);
                    System.out.println(mimePart.getContent());
                    System.out.println("========");
                }
            } else {
                System.out.println(message.getContent());
            }
        } else {
            System.out.println("INBOX中无邮件");
        }
        
        emailFolder.close(false);
        st.close();
    } catch (MessagingException e) {
        e.printStackTrace();
    } catch (IOException e) {
        e.printStackTrace();
    }
}

2. 坚持使用POP3的优化方案 #

• 服务器配置：进入邮箱设置，关闭“POP3下载后隐藏邮件”类选项（不同服务商设置路径不同）。
• JavaMail属性配置：添加props.put("mail.pop3.keepmessage", "true");，强制POP3保留服务器上的邮件（部分服务器可能不支持该属性）。
• 移除硬编码索引：始终通过messages.length - 1访问最后一封邮件，避免数组越界。

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