使用Java Mail API开发邮件客户端，无法从Dovecot获取正确索引邮件求助

Hey there! Let's figure out why you're struggling to get the correct message indices with Java Mail API, unlike mainstream clients like Thunderbird. I’ve dealt with this exact issue while building a custom mail client a while back, so here’s a detailed breakdown of the fixes that worked for me:

The biggest mistake most developers make is relying on Java Mail’s getMessage(int) method, which uses session-specific message numbers. These numbers change every time emails are deleted, moved, or new ones arrive—Thunderbird never uses them. Instead, it leverages Unique Identifiers (UIDs), which are persistent, server-assigned IDs for each email that don’t change unless the server is reconfigured.

Dovecot supports the UIDPLUS IMAP extension, so you can use Java Mail’s UIDFolder interface to work with UIDs:

Store store = session.getStore("imap");
store.connect("your-dovecot-server", "username", "password");

Folder inbox = store.getFolder("INBOX");
inbox.open(Folder.READ_WRITE);

// Check if the folder supports UIDs (it should with Dovecot)
if (inbox instanceof UIDFolder) {
    UIDFolder uidInbox = (UIDFolder) inbox;
    
    // Get all persistent UIDs in the inbox
    long[] allUids = uidInbox.getUIDs();
    
    // Fetch a specific message by its UID (this is stable across sessions)
    Message message = uidInbox.getMessageByUID(allUids[0]);
    
    // To get the UID of an existing message
    long messageUid = uidInbox.getUID(message);
}

Thunderbird constantly syncs with the server to keep its local state up to date. If you’re not explicitly syncing, Java Mail might be using stale local cache for message indices. Always sync the folder after opening it, and after any changes (like deleting/moving emails):

inbox.open(Folder.READ_WRITE);
// Full sync to pull latest server state (new emails, deletions, etc.)
inbox.sync(Folder.SYNC_FULL);

// Now get the accurate message count or UIDs
int totalMessages = inbox.getMessageCount();
long[] freshUids = ((UIDFolder) inbox).getUIDs();

Emails can arrive or be modified while your client is running—Thunderbird listens for these events and updates its index automatically. You can do the same with Java Mail’s FolderListener:

FolderListener folderUpdateListener = new FolderAdapter() {
    @Override
    public void folderChanged(FolderEvent event) {
        if (event.getType() == FolderEvent.CONTENTS_CHANGED) {
            try {
                // Re-sync the folder to get the latest UIDs/messages
                event.getFolder().sync(Folder.SYNC_FULL);
                // Refresh your message index UI or data structure here
                refreshMessageList();
            } catch (MessagingException e) {
                e.printStackTrace();
            }
        }
    }
};

// Attach the listener to your inbox
inbox.addFolderListener(folderUpdateListener);

Ensure Dovecot is configured to generate stable UIDs. Check your dovecot.conf file for these settings:

• mail_uid_format: Leave this as the default (usually %u-%v) or a format that doesn’t change for existing emails. Avoid modifying this once emails are stored, as it will invalidate existing UIDs.
• Confirm UIDPLUS is enabled: Run telnet your-dovecot-server 143, then send CAPABILITY—you should see UIDPLUS in the response. If not, enable it in Dovecot’s IMAP settings.

Java Mail might cache message data locally, leading to outdated indices. Disable caching in your session properties to force every fetch to come directly from the server:

Properties sessionProps = new Properties();
sessionProps.setProperty("mail.imap.host", "your-dovecot-server");
sessionProps.setProperty("mail.imap.port", "143");
// Disable local cache
sessionProps.setProperty("mail.imap.cache.enable", "false");
// Force full message fetch instead of partial
sessionProps.setProperty("mail.imap.fetchsize", "1048576"); // 1MB adjust as needed

Session session = Session.getInstance(sessionProps);

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