Gmail

This page is currently a placeholder for describing hints and tips for using JavaMail with Gmail. Basic Gmail usage information can be found in the JavaMail FAQ .

Gmail users might want to read the IMAP Issues page in Gmail Help.

To send email using Gmail with a different address than the one you signed in with, see this Gmail help page.

As of Mar 21, 2011, an old Gmail bug has returned. When reading an attachment, Gmail fails to return all of the data. This occurs because Gmail reports the wrong size for the attachment in the BODYSTRUCTURE response. It reports the size using Unix line terminators instead of the required MIME line terminators. The bug has been reported to Google.

As of Dec 2011, several users have reported an ArrayIndexOutOfBoundsException when accessing some messages in Gmail. This appears to be a bug in Gmail involving Subject headers with embedded newlines, although this has not yet been proven and we're still waiting for a reproducible test case.

As of Jan 2012, Gmail has a bug that causes it to fail to return a valid IMAP BODYSTRUCTURE response for messages that include another message as an attachment. Applications may see an exception with a message of "ENVELOPE parse error". The workaround described in the JavaMail FAQ can be helpful for dealing with such messages.