Next.js应用中Vercel PostgreSQL接口查询耗时异常求助

核心问题分析 #

你的代码存在几个会导致请求挂起的潜在问题：

• 未捕获的异步异常：如果查询后处理数据时出错（比如data.name不存在），async函数会抛出未处理的Promise拒绝，Express无法感知，请求会一直处于等待状态。
• 数据结构误解：Vercel PostgreSQL客户端返回的查询结果通常包含rows数组，直接访问data.name会触发报错。
• 连接管理不当：每次请求手动创建并关闭连接，容易引发连接资源耗尽或延迟问题。

修复步骤 #

1. 添加异常捕获机制 #

用try/catch包裹异步逻辑，确保错误能被捕获并返回响应，避免请求挂起：

router.get("/randomcard", async function (req, res, next) {
  let client;
  try {
    client = await db.connect();
    const result = await client.sql`SELECT * FROM Cards ORDER BY RANDOM() LIMIT 1;`;
    // Vercel PG客户端返回的结果存储在rows数组中
    const data = result.rows[0];
    console.log("Card selected from db : " + (data?.name || "未找到名称字段"));
    res.set("Cache-Control", "no-store");
    res.json(data);
  } catch (err) {
    console.error("查询错误:", err);
    res.status(500).json({ error: "获取卡片失败" });
  } finally {
    // 确保无论请求成功或失败，连接都能被关闭
    if (client) {
      await client.end();
    }
  }
});

2. 验证查询结果结构 #

先打印完整的查询结果，确认数据结构：

console.log("完整查询结果:", result);

Vercel PostgreSQL客户端返回的结构通常类似：

{
  "rows": [{"id": 1, "name": "测试卡片", ...}],
  "rowCount": 1
}

必须从rows[0]中提取单条数据，而非直接访问result.name。

3. 改用连接池（推荐） #

Vercel PostgreSQL官方建议使用连接池替代手动创建/关闭连接，避免资源浪费：

// 全局初始化连接池（仅执行一次）
const pool = db.createPool();

router.get("/randomcard", async function (req, res, next) {
  try {
    const result = await pool.sql`SELECT * FROM Cards ORDER BY RANDOM() LIMIT 1;`;
    const data = result.rows[0];
    res.set("Cache-Control", "no-store");
    res.json(data);
  } catch (err) {
    console.error("查询错误:", err);
    res.status(500).json({ error: "获取卡片失败" });
  }
});

4. 检查基础配置 #

确认Express后端的Vercel环境变量配置正确，服务拥有PostgreSQL的访问权限（同账号下Vercel服务与PostgreSQL默认内网互通，无需额外配置白名单）。

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