Next.js 13带请求体的API路由在Firebase生产环境中超时

针对你遇到的Next.js 13.4.12 AppRouter生产环境下带JSON请求体的POST/PUT请求超时、GET请求正常的问题，以下是关键排查和修复方向：

1. 修复CORS中间件，处理OPTIONS预检请求 #

生产环境中，浏览器会对带自定义头或JSON体的请求发送OPTIONS预检请求，当前你的中间件未处理这类请求，会导致后续请求卡住超时。修改中间件如下：

export async function middleware(req: NextRequest) {
  // 优先处理OPTIONS预检请求
  if (req.method === 'OPTIONS') {
    const response = new NextResponse(null, { status: 200 });
    response.headers.set("Access-Control-Allow-Origin", "*");
    response.headers.set("Access-Control-Allow-Methods", "GET, POST, PUT, DELETE");
    response.headers.set("Access-Control-Allow-Headers", "Content-Type, Authorization");
    response.headers.set("Access-Control-Max-Age", "86400");
    return response;
  }

  // 为其他请求设置CORS头
  const response = NextResponse.next();
  response.headers.set("Access-Control-Allow-Origin", "*");
  response.headers.set("Access-Control-Allow-Methods", "GET, POST, PUT, DELETE");
  response.headers.set("Access-Control-Allow-Headers", "Content-Type, Authorization");
  response.headers.set("Access-Control-Max-Age", "86400");

  console.log("\x1b[35m", "EXECUTING MIDDLEWARE-------->");
  return response;
}

2. 确认Firebase Admin生产环境初始化配置 #

开发环境可能依赖本地密钥文件，但生产环境若环境变量配置错误，会导致Firestore连接超时。确保Admin初始化使用生产环境的正确配置：

import { initializeApp, getApps, cert } from 'firebase-admin/app';
import { getFirestore } from 'firebase-admin/firestore';

if (!getApps().length) {
  initializeApp({
    credential: cert({
      projectId: process.env.FIREBASE_PROJECT_ID,
      clientEmail: process.env.FIREBASE_CLIENT_EMAIL,
      privateKey: process.env.FIREBASE_PRIVATE_KEY?.replace(/\\n/g, '\n'), // 处理环境变量中的换行符转义
    })
  });
}

export const firestoreAdmin = getFirestore();

同时确认部署平台（如Vercel、Netlify）的环境变量已正确设置FIREBASE_PROJECT_ID、FIREBASE_CLIENT_EMAIL、FIREBASE_PRIVATE_KEY。

3. 为Firestore操作添加超时控制 #

生产环境网络延迟可能导致Firestore操作超时，添加超时避免请求无限挂起：

// 在API路由中替换原有的await pageDocRef.update(body);
const updatePromise = pageDocRef.update(body);
const timeoutPromise = new Promise((_, reject) => 
  setTimeout(() => reject(new Error("Firestore update timeout")), 8000) // 设置8秒超时，需小于部署平台的函数超时限制
);

await Promise.race([updatePromise, timeoutPromise]);

4. 排查请求体解析问题 #

尝试替换request.json()为手动解析，确认是否是解析过程卡住：

// 替换原有的const body = await request.json();
const rawBody = await request.text();
const body = JSON.parse(rawBody);
console.log("body--------", body);

5. 检查Firestore安全规则与服务账号权限 #

确认生产环境Firestore的安全规则允许服务账号执行update操作，同时服务账号拥有datastore.user或对应的Firestore写入权限。可在Firebase控制台的IAM页面检查服务账号的权限配置。

6. 调整部署平台函数超时限制 #

比如Vercel的Serverless Function默认超时为10秒，若Firestore操作耗时接近该阈值，可能被平台终止请求。可在部署平台的函数设置中适当调整超时时间（如Vercel最高支持90秒）。

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