Next.js部署在Vercel上API请求出现502/504超时错误的排查与解决方案咨询

先别急着换平台，这个简单查询超时的问题大概率是可以通过优化解决的，我们一步步来排查和修复：

1. 优先排查数据库连接的问题 #

你的代码里每次请求都会调用db()，如果这个函数每次都重新建立MongoDB连接，那Serverless函数冷启动时的连接耗时很容易吃掉大部分时间，甚至直接触发10秒超时。

修复方式：把数据库连接改成单例模式 #

修改你的db.js，确保不会重复创建连接，复用已有连接：

import mongoose from 'mongoose';

// 单例连接逻辑：如果已连接则直接复用，避免每次请求重建
const connectDB = async () => {
  // readyState 1=已连接, 2=连接中，满足任一状态就复用
  if (mongoose.connection.readyState >= 1) {
    console.log("复用已有的数据库连接");
    return;
  }
  
  try {
    const startTime = Date.now();
    await mongoose.connect(process.env.MONGODB_URI, {
      // 添加参数优化连接适配MongoDB新特性
      useNewUrlParser: true,
      useUnifiedTopology: true,
    });
    console.log(`数据库连接成功，耗时${Date.now() - startTime}ms`);
  } catch (err) {
    console.error("数据库连接失败:", err);
    throw err;
  }
};

export default connectDB;

这样每次请求只会在第一次冷启动时建立连接，后续请求复用已有连接，能大幅减少初始化耗时。

2. 检查Vercel与MongoDB的区域匹配 #

如果你的MongoDB集群（比如Atlas）和Vercel的部署区域不在同一个地理位置，跨区域的网络延迟会显著增加请求耗时——比如Vercel部署在us-east-1，而MongoDB在eu-west-1，往返延迟可能就有几百毫秒甚至几秒，累积起来很容易触发超时。

修复方式： #

• 在Vercel控制台的项目设置里，把部署区域改成和MongoDB集群一致的区域
• 如果MongoDB区域不便调整，优先选择距离数据库最近的Vercel部署区域

3. 优化查询逻辑（细节里省时间） #

你的查询已经用了.lean()（这很好，能减少Mongoose的序列化开销），还可以再做两个小优化：

• 明确指定需要返回的字段，避免传输不必要的数据（比如__v字段通常不需要）
• 给常用查询字段提前加索引（目前只有9条数据影响不大，但能避免未来数据量变大后的性能问题）

修改后的查询代码：

// 只返回需要的字段，排除__v
const sections = await Section.find()
  .select("-__v")
  .lean();

4. 改用async/await简化异步逻辑 #

你的handler标记了async，但用了then/catch链式调用，虽然功能没问题，但改用async/await能让代码更清晰，也避免潜在的回调嵌套问题（比如不小心漏掉return导致函数挂起）：

import db from "../../config/db";
import Section from "../../Models/Section";

export default async function handler(req, res) {
  console.log('进入Serverless函数');
  try {
    await db(); // 确保数据库连接已建立
    const sections = await Section.find().select("-__v").lean();
    console.log('获取Sections成功:', sections);
    
    // 添加缓存头，让Vercel Edge Network缓存响应，减少后续函数调用
    res.setHeader('Cache-Control', 's-maxage=86400, stale-while-revalidate');
    return res.json(sections);
  } catch (err) {
    console.log('获取Sections失败:', err);
    return res.status(500).json({ 
      status: false, 
      msg: "发生意外问题", 
      error: err.message 
    });
  }
}

5. 添加缓存策略彻底减少函数调用 #

因为Sections数据大概率不会频繁更新，给接口加上Cache-Control头，让Vercel的Edge Network缓存响应结果。这样后续请求直接从CDN返回，根本不用触发Serverless函数，彻底解决超时问题。

上面的代码里已经配置了：

res.setHeader('Cache-Control', 's-maxage=86400, stale-while-revalidate');

这个配置表示CDN缓存1天，缓存过期后会在后台偷偷更新，不影响用户体验。

最后：是否需要切换到Heroku？ #

先把上面的优化都试一遍，90%的概率能解决问题。如果所有优化都做了还是超时，再考虑切换到非Serverless平台（比如Heroku的Web Dyno、DigitalOcean App Platform）。这类平台是长运行的服务器，没有10秒超时限制，但成本会比Vercel的Serverless高一些，而且需要自己维护服务器的运行状态。

内容的提问来源于stack exchange，提问作者Usman Abdur Rehman