Java Mail API IMAP READ_ONLY模式下邮件被标记为已读的解决咨询

这个问题我碰到过好几次，尤其是对接Gmail的IMAP服务时，明明设置了READ_ONLY模式，邮件还是会被自动标为已读，下面给你梳理核心原因和具体解决办法：

核心原因 #

虽然你指定了Folder.READ_ONLY模式，但JavaMail默认情况下，当你获取邮件内容（比如主题、正文、附件等）时，可能会触发IMAP协议的FETCH命令，部分邮件服务器（比如Gmail）会把这个操作判定为“已读”，哪怕是在只读模式下。

具体解决步骤 #

1. 添加IMAP Peek属性 #

在创建Session的Properties时，添加mail.imaps.peek=true配置，这个属性会让JavaMail使用IMAP的PEEK命令获取邮件内容，而非默认的FETCH，这样就不会修改邮件的已读状态。

修改后的Properties代码：

Properties props = System.getProperties();
props.setProperty("mail.store.protocol", "imaps");
props.setProperty("mail.imaps.peek", "true"); // 新增这行配置
Session session = Session.getInstance(props);

2. 使用FetchProfile精准获取邮件属性 #

避免直接访问Message对象属性时隐式触发全量内容获取，通过FetchProfile明确指定需要获取的邮件部分，减少不必要的服务器交互，从根源上避免触发已读标记。

示例代码：

Store store = session.getStore();
store.connect("imap.gmail.com", 993, username, password);

Folder folder = store.getFolder("Inbox");
folder.open(Folder.READ_ONLY);
IMAPFolder imapFolder = (IMAPFolder)folder;

// 获取目标范围的邮件
int startIdx = imapFolder.getMessageCount() - 5;
int endIdx = imapFolder.getMessageCount();
Message[] msgs = imapFolder.getMessages(startIdx, endIdx);

// 创建FetchProfile，指定需要获取的属性
FetchProfile fetchProfile = new FetchProfile();
fetchProfile.add(FetchProfile.Item.ENVELOPE); // 获取发件人、主题、日期等信封信息
// 如果需要邮件正文的基础信息，可以添加：fetchProfile.add(FetchProfile.Item.CONTENT_INFO);
imapFolder.fetch(msgs, fetchProfile);

// 此时访问邮件属性不会触发已读标记
for (Message msg : msgs) {
    System.out.println("主题: " + msg.getSubject());
    System.out.println("发件人: " + msg.getFrom()[0]);
}

3. 确认没有意外切换文件夹模式 #

检查代码中是否存在后续调用folder.open()的情况，比如误将模式改为READ_WRITE，这会直接覆盖之前的READ_ONLY设置。

额外注意（针对Gmail） #

如果是对接Gmail的IMAP，还需要在Gmail后台确认：

• 已开启IMAP服务（设置→转发和POP/IMAP→IMAP访问）
• 没有开启“自动将邮件标记为已读”的自定义规则

这样调整后，就能确保在READ_ONLY模式下获取邮件时，不会改变邮件的已读状态了。

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