Vercel部署后Firebase实时数据库请求超时，本地运行正常

故障场景 #

我在Vercel部署的应用中向Firebase实时数据库发送请求时遇到问题：相同请求在本地开发环境（开发和生产模式）均能正常运行，但部署到Vercel后持续出现超时和Firebase警告。

故障代码示例 #

以下是部署在Vercel时失效的Serverless函数最小可复现示例：

import { NextRequest, NextResponse } from 'next/server';
import { adminDb } from '@/lib';
import { env } from '@/lib';

const headers = {
  "Access-Control-Allow-Origin": env.CORS_ORIGIN,
  "Access-Control-Allow-Methods": "GET, OPTIONS",
  "Access-Control-Allow-Headers": "Content-Type, Authorization",
};

export async function OPTIONS(request: NextRequest) {
  return new Response(null, {
    status: 204,
    headers,
  });
}

export async function GET(request: NextRequest, context: { params: { tab: string, nameOrId: string } }) {
  if (!adminDb) {
    return NextResponse.json(
      {
        error: "Service Unavailable",
        result: "fail",
        message: "Firebase services are not available",
      },
      {
        status: 503,
        headers: headers,
      }
    );
  }

  const { tab, nameOrId } = context.params;
  const refPath = `info/${tab}/${nameOrId}`;
  const infoRef = adminDb.ref(refPath);
  const snapshot = await infoRef.get();

  if (snapshot.exists()) {
    const info = snapshot.val();
    return NextResponse.json({ success: true, info }, { status: 200, headers });
  }

  return NextResponse.json({ error: "Info not found" }, { status: 404, headers });
}

观察结果 #

• Firebase实时数据库抛出警告，但消息为{}。
• Vercel返回多个504 Gateway Timeout错误，说明Serverless函数未在10秒限制内完成。

Vercel日志 #

Aug 30 12:25:46.97
GET
---
bsb-backend.vercel.app
/api/public/images/slideshow
[2024-08-30T10:25:46.973Z] @firebase/database: FIREBASE WARNING: {}

Aug 30 12:25:46.52
GET
---
bsb-backend.vercel.app
/api/public/images/footer
[2024-08-30T10:25:46.526Z] @firebase/database: FIREBASE WARNING: {}

Aug 30 12:25:47.07
GET
---
bsb-backend.vercel.app
/api/public/images/footer
Vercel Runtime Timeout Error: Task timed out after 10 seconds

Aug 30 12:25:37.08
GET
504
bsb-backend.vercel.app
/api/public/info/mottos
[GET] /api/public/info/mottos?nxtPtab=mottos status=504

已执行步骤 #

• 确认网络连接稳定。
• 检查数据库几乎为空，数据量或延迟不应成为问题。
• 使用Firebase Admin SDK与Firebase服务交互。

Firebase初始化代码 #

以下是项目中使用的Firebase初始化代码简化版：

import * as admin from 'firebase-admin';

if (!admin.apps.length) {
  admin.initializeApp({
    credential: admin.credential.cert({
      projectId: process.env.FIREBASE_PROJECT_ID,
      clientEmail: process.env.FIREBASE_CLIENT_EMAIL,
      privateKey: process.env.FIREBASE_PRIVATE_KEY?.replace(/\\n/g, '\n'),
    }),
    databaseURL: process.env.FIREBASE_DATABASE_URL,
  });
}

const adminDb = admin.database();
const adminAuth = admin.auth();
const adminStorage = admin.storage();

export { admin, adminDb, adminAuth, adminStorage };

环境信息 #

• 部署平台： Vercel
• 数据库： Firebase Realtime Database，凭据和配置正确。
• SDK： 在Serverless函数中使用Firebase Admin SDK。

问题 #

1. 为何会出现FIREBASE WARNING: {}这类消息？
2. 为何本地正常运行的请求在Vercel上会超时？
3. 针对Firebase或Vercel，有哪些特定优化或配置可避免此类超时？

问题分析与解决方案 #

1. 为何会出现FIREBASE WARNING: {}这类消息？ #

这种空警告是Firebase SDK内部错误格式化失效导致的，本质是请求或初始化过程中出现了未被正确捕获的异常，但SDK无法输出具体错误信息。常见诱因：

• Firebase Admin SDK初始化失败，但代码仅检查admin.apps.length，未捕获初始化阶段的异常
• 环境变量格式错误，比如FIREBASE_PRIVATE_KEY的换行符替换未生效，导致凭据无效
• 网络层面无法连接到Firebase实时数据库，请求卡住后SDK抛出空警告

2. 为何本地正常运行的请求在Vercel上会超时？ #

本地与Vercel环境的核心差异导致：

• 网络限制：Vercel Serverless函数的出站网络可能存在端口或IP限制，无法正常连接Firebase实时数据库
• 环境变量问题：Vercel上环境变量的加载格式与本地不同，比如私钥换行符处理错误，导致SDK初始化不完整
• 冷启动延迟：Serverless函数冷启动时，Firebase SDK初始化耗时叠加请求延迟，超过Vercel的10秒超时限制
• IP白名单：Firebase实时数据库若设置了IP白名单，Vercel的动态出站IP不在名单内，导致请求被阻塞

3. 针对性优化与配置方案 #

（1）修复Firebase初始化的异常处理

添加初始化阶段的异常捕获，输出详细错误日志：

import * as admin from 'firebase-admin';

let adminDb;
let adminAuth;
let adminStorage;

try {
  if (!admin.apps.length) {
    admin.initializeApp({
      credential: admin.credential.cert({
        projectId: process.env.FIREBASE_PROJECT_ID,
        clientEmail: process.env.FIREBASE_CLIENT_EMAIL,
        privateKey: process.env.FIREBASE_PRIVATE_KEY?.replace(/\\n/g, '\n'),
      }),
      databaseURL: process.env.FIREBASE_DATABASE_URL,
    });
  }
  adminDb = admin.database();
  adminAuth = admin.auth();
  adminStorage = admin.storage();
} catch (error) {
  console.error('Firebase初始化失败:', error);
}

export { admin, adminDb, adminAuth, adminStorage };

（2）验证Vercel环境变量配置

• 在Vercel控制台直接粘贴原始Firebase私钥，无需手动转义换行符，Vercel会自动处理格式
• 确保预览环境与生产环境的环境变量同步，避免部署遗漏

（3）优化Serverless函数性能

• 改用Vercel边缘函数（Edge Functions）：边缘节点网络延迟更低，超时限制最高可达60秒
• 给Firebase请求添加超时控制，避免无限等待：

  // 给请求添加8秒超时（小于Vercel的10秒限制）
  const snapshot = await Promise.race([
    infoRef.get(),
    new Promise((_, reject) => setTimeout(() => reject(new Error('请求超时')), 8000))
  ]);
  

（4）检查Firebase安全配置

• 登录Firebase控制台，确认实时数据库规则未设置IP限制（Admin SDK默认绕过规则，但IP白名单会直接拦截请求）
• 若必须使用IP白名单，添加Vercel官方公布的出站IP段（注意IP段可能更新，长期建议使用无IP限制的认证方式）

（5）增加日志调试

在函数中添加关键节点的日志，定位延迟来源：

console.log('Firebase DB初始化状态:', !!adminDb);
const start = Date.now();
const snapshot = await infoRef.get();
console.log('Firebase请求耗时:', Date.now() - start, 'ms');

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