Next.js部署到Vercel后如何在发送HTTP响应后执行代码

你遇到的表现差异本质是运行环境的机制不同：

• 本地开发时Next.js跑在常驻Node.js进程上，事件循环会在res.send()返回响应后继续执行后续代码，和Express逻辑一致
• Vercel部署的Serverless Functions遵循平台调度规则：一旦HTTP响应完整返回给客户端，当前函数实例会被立刻冻结、回收，未执行完的异步代码会直接终止，不存在常驻进程留着跑后置逻辑，所以响应后写的代码不会完整执行。

把耗时逻辑放在响应前await的写法会受函数超时限制：Vercel免费版函数最长执行时间仅10秒，Pro版最高也只有60秒，批量发邮件这类带速率限制的长耗时任务很容易触发超时。

1. 短耗时后置任务用waitUntilAPI #

如果你的后置任务执行时间在当前套餐的函数超时上限以内，可以直接用Vercel官方提供的waitUntil方法，它会告知平台当前实例还有待执行任务，不要提前回收，等任务执行完再销毁实例。
代码示例（App Router路由写法）：

import { NextResponse } from 'next/server';
import { waitUntil } from '@vercel/functions';

// 你的批量发邮件逻辑
async function sendBatchEmails() {
  // 按速率限制逐批调用邮件API
}

export async function POST() {
  // 注册后置执行的异步任务，不需要await
  waitUntil(sendBatchEmails());
  // 立刻返回响应给客户端
  return NextResponse.json({ success: true, message: "邮件任务已启动" });
}

Pages Router的接口可以用同样的逻辑，在返回响应前调用waitUntil包裹耗时任务即可。

2. 长耗时任务用队列+定时任务解耦 #

如果你的任务执行时间超过函数最大超时上限（比如带严格速率限制的批量发邮件、大批量数据处理），不要在请求链路里执行任务逻辑，走解耦方案：

• 收到用户请求后，只做参数校验，把待执行的任务信息（比如收件人列表、邮件模板ID）持久化存储到数据库/缓存中，标记任务为「待处理」状态
• 立刻返回HTTP响应给客户端，告知用户任务已提交
• 配置定时任务，按固定频率（比如每1分钟触发一次）拉取存储中「待处理」的任务，按照速率限制要求逐步执行，执行完成后更新任务状态，支持失败重试
  这种方案完全不受HTTP函数的超时限制，哪怕任务需要执行几十分钟甚至几小时都能稳定运行，是生产环境处理这类场景的标准方案。

• 不要试图用不await的异步调用、setTimeout等方式实现响应后执行逻辑，这类写法在Serverless环境下没有可靠性保障，大概率会在响应返回后被平台掐断，导致任务执行一半失败
• 不要为了跑长任务盲目拉长函数超时配置，既容易触发平台限流，也会产生额外的函数执行费用

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