如何使用javax.mail将邮件从一个文件夹移动到另一个？

方法一：通用兼容方案（复制+删除） #

如果目标IMAP服务器不支持原生MOVE命令，或使用的javax.mail版本较低，可通过复制邮件到目标文件夹后标记源邮件为删除并清除的方式实现移动效果：

// 假设已完成Session、IMAPStore的初始化与连接
Folder inbox = store.getFolder("INBOX");
// 必须以READ_WRITE模式打开，否则无法修改邮件状态
inbox.open(Folder.READ_WRITE);

// 打开或创建目标自定义文件夹
Folder targetFolder = store.getFolder("MY_APPLICATION_FOLDER");
if (!targetFolder.exists()) {
    // 创建普通邮件文件夹
    targetFolder.create(Folder.HOLDS_MESSAGES);
}
targetFolder.open(Folder.READ_WRITE);

// 替换为你需要移动的特定邮件集合
Message[] messagesToMove = ...;

// 复制邮件到目标文件夹
inbox.copyMessages(messagesToMove, targetFolder);

// 标记源邮件为删除状态
for (Message msg : messagesToMove) {
    msg.setFlag(Flags.Flag.DELETED, true);
}

// 清除已标记为删除的邮件
inbox.expunge();

// 关闭文件夹：close(true)会自动执行expunge，可替代手动expunge()
targetFolder.close(false);
inbox.close(true);

方法二：高效原生MOVE命令（推荐） #

从javax.mail 1.5.1版本开始，支持IMAP原生MOVE命令，无需复制+删除，直接完成移动操作，效率更高：

// 强制转为IMAPFolder以使用moveMessages方法
IMAPFolder inbox = (IMAPFolder) store.getFolder("INBOX");
inbox.open(Folder.READ_WRITE);

IMAPFolder targetFolder = (IMAPFolder) store.getFolder("MY_APPLICATION_FOLDER");
if (!targetFolder.exists()) {
    targetFolder.create(Folder.HOLDS_MESSAGES);
}
targetFolder.open(Folder.READ_WRITE);

// 替换为你需要移动的特定邮件集合
Message[] messagesToMove = ...;

// 直接调用moveMessages完成移动
inbox.moveMessages(messagesToMove, targetFolder);

// 关闭文件夹，无需额外清除操作
targetFolder.close(false);
inbox.close(false);

关键注意事项 #

• 源文件夹必须以Folder.READ_WRITE模式打开，否则无法执行删除或移动操作
• 目标文件夹需提前确认存在，不存在时调用create()方法创建（注意服务器是否允许创建自定义文件夹）
• 若使用方法一，调用inbox.close(true)会自动执行expunge，可省略手动expunge()调用
• 部分老旧IMAP服务器可能不支持原生MOVE命令，此时 fallback 到方法一即可

内容的提问来源于stack exchange，提问作者Tiago Dall'Oca