Java中接收郵件的核心是使用javamail api連接郵件服務器并解析內容。1. 引入javamail api依賴，maven或gradle配置對應庫；2. 配置連接信息，包括服務器地址、端口、用戶名和密碼，并啟用ssl及適當認證方式；3. 編寫代碼連接imap服務器（如gmail的imap.gmail.com:993），獲取并遍歷郵件消息，解析主題、發件人和內容，處理多部分內容和附件；4. 使用oauth 2.0認證時，創建google cloud項目并啟用gmail api，獲取client id、client secret和refresh Token，通過google java client library獲取access token用于連接；5. 解決常見問題如連接超時或ssl握手失敗，檢查網絡、端口、ssl設置，添加證書到信任庫，并設置合理的超時時間。
Java中接收郵件，簡單來說，就是利用JavaMail API，連接郵件服務器，然后像拆包裹一樣，把郵件從服務器上取下來，再解析里面的內容。這事兒聽起來簡單，但實際操作起來，會遇到各種各樣的小問題。
解決方案
-
引入JavaMail API依賴：
立即學習“Java免費學習筆記（深入）”；
首先，你需要把JavaMail API的依賴添加到你的項目中。如果你用Maven，就在pom.xml里添加：
<dependency> <groupId>com.sun.mail</groupId> <artifactId>javax.mail</artifactId> <version>1.6.2</version> <!-- 找個最新版本 --> </dependency>
如果是Gradle，就在build.gradle里添加：
implementation 'com.sun.mail:javax.mail:1.6.2' // 找個最新版本
-
配置連接信息：
你需要知道郵件服務器的地址、端口、用戶名和密碼。這些信息通常可以在你的郵箱設置里找到。比如，用Gmail，可能需要開啟“允許不夠安全的應用訪問” (現在不推薦，建議使用OAuth 2.0)，或者開啟應用專用密碼。
-
編寫代碼接收郵件：
下面是一個簡單的例子，演示如何連接到郵件服務器并獲取郵件：
import javax.mail.*; import javax.mail.internet.MimeMessage; import java.util.Properties; public class EmailReceiver { public static void main(String[] args) { String host = "imap.gmail.com"; // IMAP服務器地址 String username = "your_email@gmail.com"; // 你的郵箱 String password = "your_password"; // 你的密碼 Properties props = new Properties(); props.put("mail.store.protocol", "imap"); props.put("mail.imap.host", host); props.put("mail.imap.port", "993"); // IMAP端口，通常是993（SSL）或143（非SSL） props.put("mail.imap.ssl.enable", "true"); // 啟用SSL try { Session session = Session.getDefaultInstance(props); Store store = session.getStore("imap"); store.connect(host, username, password); Folder inbox = store.getFolder("INBOX"); inbox.open(Folder.READ_ONLY); Message[] messages = inbox.getMessages(); System.out.println("收件箱郵件數量: " + messages.length); for (int i = 0; i < messages.length; i++) { Message message = messages[i]; System.out.println("主題: " + message.getSubject()); System.out.println("發件人: " + message.getFrom()[0]); System.out.println("內容: " + getTextFromMessage(message)); // 處理郵件內容 } inbox.close(false); store.close(); } catch (MessagingException e) { e.printStackTrace(); } catch (Exception e) { e.printStackTrace(); } } private static String getTextFromMessage(Message message) throws Exception { if (message instanceof MimeMessage) { MimeMessage mimeMessage = (MimeMessage) message; Object content = mimeMessage.getContent(); if (content instanceof String) { return (String) content; } else if (content instanceof Multipart) { Multipart multipart = (Multipart) content; return getTextFromMultipart(multipart); } } return ""; } private static String getTextFromMultipart(Multipart multipart) throws Exception { StringBuilder result = new StringBuilder(); for (int i = 0; i < multipart.getCount(); i++) { BodyPart bodyPart = multipart.getBodyPart(i); if (bodyPart.isMimeType("text/plain")) { result.append("n").append(bodyPart.getContent()); } else if (bodyPart.getContent() instanceof MimeMultipart){ result.append(getTextFromMultipart((MimeMultipart)bodyPart.getContent())); } } return result.toString(); } }這段代碼會連接到你的Gmail收件箱，打印出郵件的主題、發件人和內容。注意替換your_email@gmail.com和your_password為你的真實郵箱和密碼。
-
處理郵件內容：
郵件內容可能包含純文本、html、附件等。你需要根據郵件的Content-Type來選擇合適的處理方式。getTextFromMessage方法簡單處理了文本和Multipart類型的內容，實際應用中可能需要更復雜的邏輯來解析HTML郵件和處理附件。
如何處理郵件中的附件？
處理附件的關鍵在于識別BodyPart的Disposition。如果Disposition是Part.ATTACHMENT，那么它就是一個附件。你可以使用bodyPart.getInputStream()來獲取附件的輸入流，然后保存到本地文件。
if (Part.ATTACHMENT.equalsIgnoreCase(bodyPart.getDisposition())) { String filename = bodyPart.getFileName(); InputStream is = bodyPart.getInputStream(); // 保存附件到本地 FileOutputStream fos = new FileOutputStream("path/to/save/" + filename); byte[] buffer = new byte[4096]; int bytesRead; while ((bytesRead = is.read(buffer)) != -1) { fos.write(buffer, 0, bytesRead); } fos.close(); is.close(); }
如何使用OAuth 2.0認證來連接Gmail？
直接使用用戶名和密碼連接Gmail已經不推薦了，建議使用OAuth 2.0。這需要你創建一個Google Cloud項目，啟用Gmail API，然后獲取Client ID、Client Secret和Refresh Token。
-
創建Google Cloud項目并啟用Gmail API：
- 訪問Google Cloud Console，創建一個新項目。
- 在API和服務中，搜索并啟用Gmail API。
- 配置OAuth同意屏幕，設置應用名稱、用戶支持郵箱等。
- 創建OAuth 2.0客戶端ID，選擇“桌面應用”類型，獲取Client ID和Client Secret。
-
獲取Refresh Token：
你需要使用Client ID和Client Secret來獲取Refresh Token。可以使用Google提供的OAuth 2.0 Playground (https://www.php.cn/link/b2b8d291ff95907f8fb6f21337c07331) 來完成這個步驟。
- 在OAuth 2.0 Playground中，選擇Gmail API v1，并授權你的應用訪問Gmail。
- 交換授權碼以獲取Access Token和Refresh Token。
-
使用Refresh Token連接Gmail：
使用Google提供的Java Client Library for OAuth 2.0來獲取Access Token，然后使用這個Access Token來連接Gmail。
import com.google.api.client.auth.oauth2.Credential; import com.google.api.client.googleapis.auth.oauth2.GoogleCredential; import com.google.api.client.http.javanet.NetHttpTransport; import com.google.api.client.json.jackson2.JacksonFactory; // ... 其他必要的import public class GmailOAuthReceiver { private static final String CLIENT_ID = "your_client_id"; private static final String CLIENT_SECRET = "your_client_secret"; private static final String REFRESH_TOKEN = "your_refresh_token"; public static void main(String[] args) { try { Credential credential = new GoogleCredential.Builder() .setTransport(new NetHttpTransport()) .setJsonFactory(new JacksonFactory()) .setClientSecrets(CLIENT_ID, CLIENT_SECRET) .build() .setRefreshToken(REFRESH_TOKEN); Properties props = new Properties(); props.put("mail.store.protocol", "imap"); props.put("mail.imap.host", "imap.gmail.com"); props.put("mail.imap.port", "993"); props.put("mail.imap.ssl.enable", "true"); props.put("mail.imap.auth.mechanisms", "XOAUTH2"); // 使用XOAUTH2認證 Session session = Session.getInstance(props, new Authenticator() { @Override protected PasswordAuthentication getPasswordAuthentication() { try { credential.refreshToken(); // 刷新Access Token String accessToken = credential.getAccessToken(); return new PasswordAuthentication("your_email@gmail.com", accessToken); } catch (Exception e) { e.printStackTrace(); return null; } } }); Store store = session.getStore("imap"); store.connect("imap.gmail.com", "your_email@gmail.com", null); // 用戶名和密碼使用null // ... 剩下的代碼和之前一樣，獲取郵件并處理 } catch (Exception e) { e.printStackTrace(); } } }
注意替換your_client_id、your_client_secret和your_refresh_token為你的真實信息。
如何解決連接超時或SSL握手失敗的問題？
-
檢查網絡連接： 確保你的程序可以訪問郵件服務器。
-
檢查端口和SSL設置： 確保你使用了正確的端口（通常是993 for IMAP/SSL，465 for SMTP/SSL）并且啟用了SSL。
-
信任證書： 如果你遇到了SSL握手失敗的問題，可能是因為你的Java環境不信任郵件服務器的證書。你可以嘗試將郵件服務器的證書添加到你的Java信任庫中。
-
設置超時時間： 可以通過設置mail.imap.connectiontimeout和mail.imap.timeout屬性來控制連接超時時間。
props.put("mail.imap.connectiontimeout", "5000"); // 5秒連接超時 props.put("mail.imap.timeout", "5000"); // 5秒讀取超時
總之，Java接收郵件是一個相對復雜的過程，需要你了解JavaMail API、郵件協議（IMAP/POP3）、認證方式（用戶名/密碼、OAuth 2.0）以及一些常見的錯誤處理。希望這些信息能幫助你順利地實現郵件接收功能。
