Java中Gmail API的Message实例如何编码为URL安全Base64格式？

要解决Required parameter Message.getRaw() must be specified错误，你需要将完整的邮件内容编码为URL安全的Base64格式并设置到Message的raw字段中，具体步骤如下：

1. 构建完整的MimeMessage #

先使用JavaMail的MimeMessage类构建包含收件人、主题、正文等完整信息的邮件：

import javax.mail.Session;
import javax.mail.internet.InternetAddress;
import javax.mail.internet.MimeMessage;
import java.util.Properties;

// 初始化JavaMail会话
Properties props = new Properties();
Session session = Session.getDefaultInstance(props, null);

// 构建MimeMessage
MimeMessage mimeMessage = new MimeMessage(session);
mimeMessage.setFrom(new InternetAddress("your-email@gmail.com"));
mimeMessage.addRecipient(MimeMessage.RecipientType.TO, new InternetAddress("recipient@example.com"));
mimeMessage.setSubject("邮件主题");
mimeMessage.setText("邮件正文内容");

2. 将MimeMessage转换为字节数组 #

通过ByteArrayOutputStream将MimeMessage写入字节数组：

import java.io.ByteArrayOutputStream;
import java.io.IOException;
import javax.mail.MessagingException;

ByteArrayOutputStream baos = new ByteArrayOutputStream();
try {
    mimeMessage.writeTo(baos);
} catch (IOException | MessagingException e) {
    e.printStackTrace();
}
byte[] emailBytes = baos.toByteArray();

3. 进行URL安全的Base64编码 #

使用Java自带的Base64工具类生成符合Gmail要求的URL安全编码（替换+为-、/为_，去掉末尾填充的=）：

import java.util.Base64;

String encodedEmail = Base64.getUrlEncoder().withoutPadding().encodeToString(emailBytes);

4. 设置Message的raw字段并发送 #

将编码后的字符串设置到Gmail API的Message对象中，再调用发送接口：

com.google.api.services.gmail.model.Message message = new com.google.api.services.gmail.model.Message();
message.setRaw(encodedEmail);

// 执行发送
service.users().messages().send("me", message).execute();

关键说明 #

• 直接设置payload无法满足Gmail API的发送要求，必须通过raw字段传递完整的编码后邮件内容
• URL安全的Base64编码是Gmail API的强制要求，普通Base64编码会导致请求失败

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