如何使用JavaMail在同邮件服务器复制邮件并保留原UID？

问题分析 #

你当前的代码通过索引匹配源和目标邮件的UID，这种逻辑完全错误——源与目标邮箱的邮件索引没有对应关系，根本无法判断邮件是否已复制，自然会导致重复。另外，IMAP协议中UID是文件夹本地唯一标识，由服务器分配，不同邮箱的UID空间相互独立，无法强制让目标邮件的UID与源邮件完全一致，所以核心需求应该是通过邮件的全局唯一标识避免重复复制。

正确实现思路 #

利用邮件的Message-ID（全局唯一，合法邮件都会携带）判断目标邮箱是否已存在该邮件，只复制未存在的邮件。同时使用UIDFolder接口提升IMAP操作的效率。

代码示例 #

基础版本（适合目标邮件较少的场景） #

import javax.mail.*;
import javax.mail.search.MessageIDTerm;
import java.util.Properties;
import java.util.HashSet;
import java.util.Set;

public class EmailCopy {
    public static void main(String[] args) throws Exception {
        // 配置IMAP会话
        Properties props = new Properties();
        props.setProperty("mail.store.protocol", "imap");
        props.setProperty("mail.imap.host", "你的邮件服务器地址");
        props.setProperty("mail.imap.port", "143");
        // SSL连接请使用以下配置
        // props.setProperty("mail.store.protocol", "imaps");
        // props.setProperty("mail.imaps.host", "你的邮件服务器地址");
        // props.setProperty("mail.imaps.port", "993");

        Session session = Session.getInstance(props);

        // 连接源邮箱
        Store sourceStore = session.getStore();
        sourceStore.connect("test@test.com", "源邮箱密码");
        Folder sourceFolder = sourceStore.getFolder("INBOX");
        sourceFolder.open(Folder.READ_ONLY);

        // 连接目标邮箱
        Store targetStore = session.getStore();
        targetStore.connect("test-backup@test.com", "目标邮箱密码");
        Folder targetFolder = targetStore.getFolder("INBOX");
        targetFolder.open(Folder.READ_WRITE);

        // 收集目标邮箱已有的所有Message-ID
        Set<String> existingMsgIds = new HashSet<>();
        Message[] targetMsgs = targetFolder.getMessages();
        for (Message msg : targetMsgs) {
            String msgId = msg.getMessageID();
            if (msgId != null) {
                existingMsgIds.add(msgId);
            }
        }

        // 遍历源邮箱邮件，复制未存在的邮件
        Message[] sourceMsgs = sourceFolder.getMessages();
        for (Message sourceMsg : sourceMsgs) {
            String sourceMsgId = sourceMsg.getMessageID();
            if (sourceMsgId != null && !existingMsgIds.contains(sourceMsgId)) {
                targetFolder.copyMessages(new Message[]{sourceMsg}, targetFolder);
                existingMsgIds.add(sourceMsgId); // 避免本次循环重复处理
            }
        }

        // 关闭资源
        sourceFolder.close(false);
        sourceStore.close();
        targetFolder.close(false);
        targetStore.close();
    }
}

高效版本（适合目标邮件较多的场景） #

通过IMAP的SEARCH功能直接查询目标邮箱是否存在对应Message-ID的邮件，无需加载所有目标邮件到本地：

// 替换基础版本中的遍历复制部分
Message[] sourceMsgs = sourceFolder.getMessages();
for (Message sourceMsg : sourceMsgs) {
    String sourceMsgId = sourceMsg.getMessageID();
    if (sourceMsgId != null) {
        // 搜索目标邮箱中是否有相同Message-ID的邮件
        MessageIDTerm searchTerm = new MessageIDTerm(sourceMsgId);
        Message[] foundMsgs = targetFolder.search(searchTerm);
        if (foundMsgs == null || foundMsgs.length == 0) {
            targetFolder.copyMessages(new Message[]{sourceMsg}, targetFolder);
        }
    }
}

关键说明 #

1. 关于UID保留：IMAP协议中UID是文件夹本地唯一的，由服务器分配，不同邮箱的UID空间相互独立，无法强制让目标邮件UID与源邮件一致，这是服务器的机制决定的。
2. Message-ID的可靠性：正规邮件都会生成唯一的Message-ID，以此作为重复判断的依据是最可靠的方案。
3. 资源关闭：操作完成后务必关闭Folder和Store，避免连接泄漏。

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