Next.js 15集成Gmail回复异常：收件方收新邮件而非会话内邮件

你的问题核心是：回复邮件仅在己方Gmail会话中显示正常，但收件方收到的是独立邮件，未归入原有会话。这是因为收件方邮件客户端（如Gmail）依赖邮件头的特定字段来关联会话，而你的当前代码缺少关键主题头，且编码方式不符合Gmail API要求。

关键问题点 #

1. 缺失Subject主题头：收件方客户端会通过主题（尤其是带Re:前缀的回复主题）匹配会话，无主题或主题不匹配会导致邮件被视为新会话。
2. Base64编码不符合要求：Gmail API要求raw字段使用URL-safe的Base64编码，普通Base64的+、/、=字符会破坏邮件头解析。
3. References头可优化：若为多轮回复，References应包含会话中所有历史邮件的Message-ID（至少包含原始邮件的ID）。

修改后的代码 #

假设前端传递原始邮件的主题originalSubject（若未传递，可通过Gmail API调用获取原始邮件主题）：

import { google } from 'googleapis';

export async function POST(req) {
  // 新增originalSubject参数，从请求中获取
  const { threadId, messageId, to, replyText, accessToken, from, originalSubject } = await req.json();
  const auth = new google.auth.OAuth2();
  auth.setCredentials({ access_token: accessToken });
  const gmail = google.gmail({ version: 'v1', auth });

  // 构建完整邮件头，添加回复主题
  const rawMessage = [
    `From: ${from}`,
    `To: ${to}`,
    `In-Reply-To: ${messageId}`,
    // 多轮回复可追加历史Message-ID，格式为"messageId1 messageId2"
    `References: ${messageId}`,
    `Subject: Re: ${originalSubject}`, // 新增回复主题
    `MIME-Version: 1.0`,
    `Content-Type: text/plain; charset=UTF-8`,
    ``,
    replyText,
  ].join('\n');

  // 转换为URL-safe的Base64编码
  const encodedMessage = Buffer.from(rawMessage)
    .toString('base64')
    .replace(/\+/g, '-')
    .replace(/\//g, '_')
    .replace(/=+$/, '');

  try {
    await gmail.users.messages.send({
      userId: 'me',
      requestBody: {
        raw: encodedMessage,
        threadId: threadId,
      },
    });
    return new Response(JSON.stringify({ status: 'Reply sent successfully' }), {
      status: 200,
      headers: { 'Content-Type': 'application/json' },
    });
  } catch (error) {
    return new Response(JSON.stringify({ error: error.message }), {
      status: 500,
      headers: { 'Content-Type': 'application/json' },
    });
  }
}

补充说明 #

• 若无法从前端获取originalSubject，可在后端通过以下方式获取原始邮件主题：

  const originalMessage = await gmail.users.messages.get({
    userId: 'me',
    id: messageId,
    format: 'metadata',
    metadataHeaders: ['Subject']
  });
  const originalSubject = originalMessage.data.payload.headers.find(h => h.name === 'Subject')?.value || '';
  

• 确保messageId是原始邮件的Message-ID（即Gmail API返回的messages.id字段，与邮件头中的Message-ID一致）。
• threadId参数仅确保己方Gmail会话正确，收件方的会话关联完全依赖邮件头的Subject、In-Reply-To、References字段。

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