Node.js中如何使用Gmail API基于已有threadId回复邮件而非新建线程

1. 发送请求参数字段错误 #

你在resource配置里错误使用了message_id字段，Gmail API v1的users.messages.send接口用于指定所属线程的合法字段为threadId，非法字段会被接口直接忽略，等于没有传线程标识。

2. 邮件MIME头缺少线程关联必要标识 #

仅传threadId无法保证回复稳定归入原线程，符合RFC标准的邮件线程关联依赖In-Reply-To、References两个头字段，你的makeBody函数完全没有生成这两个字段。

3. 邮件主题与原线程不匹配 #

如果回复的Subject和原线程主题不一致，哪怕传了正确的threadId，也有概率被Gmail拆分到新线程。

第一步：从原邮件中提取必要头信息 #

从你已检索到的原邮件对象的payload.headers数组中提取3个字段（每个header对象包含name和value属性）：

• 找到name: "Message-ID"对应的value，即原邮件的唯一标识
• 找到name: "Subject"对应的value，即原邮件主题
• 找到name: "References"对应的value，如果不存在则为空字符串

参考提取逻辑：

// originalEmail为你之前检索到的包含threadId的原邮件对象
const headers = originalEmail.payload.headers;

const originalMessageId = headers.find(h => h.name === "Message-ID")?.value || "";
const originalSubject = headers.find(h => h.name === "Subject")?.value || "";
const originalReferences = headers.find(h => h.name === "References")?.value || "";

// 构造回复专用头
const replySubject = originalSubject.startsWith("Re:") ? originalSubject : `Re: ${originalSubject}`;
const replyReferences = originalReferences ? `${originalReferences} ${originalMessageId}` : originalMessageId;

第二步：修正makeBody函数，补充关联头 #

修改makeBody的入参和生成逻辑，新增In-Reply-To、References头：

function makeBody(to, from, subject, message, inReplyTo, references) {
    const str = [
        "Content-Type: text/plain; charset=\"UTF-8\"\n",
        "MIME-Version: 1.0\n",
        "Content-Transfer-Encoding: 7bit\n",
        `to: ${to}\n`,
        `from: ${from}\n`,
        `subject: ${subject}\n`,
        `In-Reply-To: ${inReplyTo}\n`,
        `References: ${references}\n\n`,
        message
    ].join('');

    // 你当前的URL安全base64编码逻辑符合Gmail API要求，保留即可
    return Buffer.from(str).toString("base64").replace(/\+/g, '-').replace(/\//g, '_');
}

第三步：修正发送请求参数 #

将原请求中错误的message_id替换为合法的threadId，同时调用修正后的makeBody传入新的头参数：

function sendMessage(auth) {
    try {
        const originalEmail = /* 你之前检索到的原邮件对象 */;
        // 执行第一步的头提取逻辑
        const headers = originalEmail.payload.headers;
        const originalMessageId = headers.find(h => h.name === "Message-ID")?.value || "";
        const originalSubject = headers.find(h => h.name === "Subject")?.value || "";
        const originalReferences = headers.find(h => h.name === "References")?.value || "";
        const replySubject = originalSubject.startsWith("Re:") ? originalSubject : `Re: ${originalSubject}`;
        const replyReferences = originalReferences ? `${originalReferences} ${originalMessageId}` : originalMessageId;

        // 传入新增的关联头参数
        const raw = makeBody(
            'abc@gmail.com', // 收件人需和原邮件发件人一致
            'xyz@gmail.com', // 发件人需和原邮件收件人一致
            replySubject,
            'workinggggggg...',
            originalMessageId,
            replyReferences
        );

        const gmail = google.gmail({ version: 'v1', auth });
        gmail.users.messages.send({
            auth: auth,
            userId: 'me',
            resource: {
                raw: raw,
                // 修正字段名，直接使用原邮件的threadId即可
                threadId: originalEmail.threadId
            }
        }, function (err, response) {
            if (err) {
                return console.log('The API returned an error: ' + err);
            }
            console.log('回复已归入原线程，响应：', response.data);
        });
    } catch (error) {
        console.log(error);
    }
}

• 提取Message-ID时不要修改其原始值，包括首尾的尖括号，需完全和原邮件的Message-ID一致
• 如果发送后仍被分到新线程，优先检查In-Reply-To、References的值是否有多余空格或换行符
• 不要自行修改threadId的值，直接使用原邮件检索结果中的threadId字段即可

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