Vercel部署NextJS服务端函数未完成Azure邮件发送即终止

核心问题修复：确保邮件发送逻辑被正确await #

Vercel无服务器函数的核心特性是返回响应后立即终止所有未完成的异步操作，你之前的代码里main()函数未被await就直接返回响应，导致邮件发送的异步流程被强制中断。正确的做法是让所有关键异步操作（数据库写入+邮件发送）全部完成后，再返回响应。

修改api/register/route.ts的核心逻辑：

export async function POST(request: Request) {
  try {
    // 1. 解析并保存用户数据到数据库（确保这里也用await）
    const userPayload = await request.json();
    const newUser = await saveUserToDatabase(userPayload);

    // 2. 封装并await邮件发送逻辑
    await sendActivationEmail(newUser.email, newUser.activationToken);

    // 3. 所有异步任务完成后再返回成功响应
    return new Response(JSON.stringify({
      message: "注册成功，激活邮件已发送"
    }), {
      status: 200,
      headers: { "Content-Type": "application/json" }
    });
  } catch (error) {
    // 捕获异常并返回错误响应
    return new Response(JSON.stringify({
      message: "注册失败"
    }), {
      status: 500,
      headers: { "Content-Type": "application/json" }
    });
  }
}

// 独立封装邮件发送逻辑
async function sendActivationEmail(targetEmail: string, token: string) {
  // 初始化Azure邮件客户端
  const emailClient = new EmailClient(process.env.AZURE_EMAIL_CONNECTION_STRING);
  
  // 构造激活邮件内容
  const emailMessage = {
    senderAddress: process.env.AZURE_SENDER_EMAIL,
    toRecipients: [{ address: targetEmail }],
    subject: "账户激活",
    htmlContent: `<p>点击链接激活账户：<a href="${process.env.APP_URL}/activate?token=${token}">激活</a></p>`
  };

  // 发送邮件并等待完成
  const poller = await emailClient.beginSend(emailMessage);
  await poller.pollUntilDone();
}

关于延迟返回时的"headers"错误 #

你之前尝试添加超时延迟返回出现的错误，本质是错误的异步处理方式破坏了Response对象的构造逻辑。不要用延迟作为解决方案，这不仅会增加函数运行时间（可能触发Vercel的超时限制），还无法从根本上解决异步任务被终止的问题。正确await所有异步任务才是唯一可靠的方式。

备选方案：用Vercel Queue异步处理邮件发送 #

如果不想让用户等待邮件发送完成（比如邮件发送耗时较长），可以使用Vercel的Queue功能将邮件任务异步化：

1. 首先安装依赖：

npm install @vercel/kv

2. 修改注册接口，将邮件任务加入队列：

import { Queue } from '@vercel/kv';

// 初始化邮件队列
const emailQueue = new Queue('activation-emails');

export async function POST(request: Request) {
  try {
    const userPayload = await request.json();
    const newUser = await saveUserToDatabase(userPayload);

    // 将邮件任务加入队列，异步执行
    await emailQueue.enqueue({
      email: newUser.email,
      token: newUser.activationToken
    });

    return new Response(JSON.stringify({
      message: "注册成功，激活邮件将稍后发送"
    }), { status: 200 });
  } catch (error) {
    return new Response(JSON.stringify({ message: "注册失败" }), { status: 500 });
  }
}

3. 创建队列处理接口（比如api/queue/activation-email/route.ts）：

export async function POST(request: Request) {
  const job = await request.json();
  await sendActivationEmail(job.email, job.token);
  return new Response(JSON.stringify({ processed: true }), { status: 200 });
}

// 复用之前的sendActivationEmail函数
async function sendActivationEmail(targetEmail: string, token: string) {
  const emailClient = new EmailClient(process.env.AZURE_EMAIL_CONNECTION_STRING);
  const emailMessage = { /* 构造邮件内容 */ };
  const poller = await emailClient.beginSend(emailMessage);
  await poller.pollUntilDone();
}

额外排查点 #

• 确认Vercel环境变量中配置的Azure邮件服务连接字符串、发件人邮箱等信息正确，没有和本地环境不一致的情况。
• 登录Azure Portal查看邮件发送日志，确认是否存在配额耗尽、内容被拦截等Azure侧的错误。

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