Firebase Functions超时异常：runWith配置无效及部署权限问题

一、模拟器环境超时异常 #

问题表现 #

• 函数实际仅执行5秒，却返回 { code: "ECONNRESET" }，控制台错误提示为functions: Your function timed out after ~300s
• 日志存在矛盾：先显示functions: Finished "app" in 4102.929386ms，5秒后却触发300秒超时终止提示
• 配置timeoutSeconds: 300完全无效

解决方法 #

这是firebase-functions@3.18.0版本模拟器的已知逻辑bug，超时检测机制与函数实际执行生命周期不匹配。

1. 核心根治方案：升级依赖
   把firebase-functions和Firebase CLI升级到最新稳定版，新版本已修复该模拟器超时检测问题。

2. 临时规避方案（无法升级时）
   用Promise封装异步延迟逻辑，替代直接使用setTimeout，让模拟器正确识别函数执行状态：

   const functions = require("firebase-functions");
   const cors = require('cors')({
     origin: true,
   });
   
   exports.app = functions.runWith({
     timeoutSeconds: 300
   }).https.onRequest((req, res) => {
     cors(req, res, async () => {
       await new Promise(resolve => setTimeout(resolve, 5000));
       res.send({result: 'success'});
     });
   });
   

二、部署后环境403 Forbidden异常 #

问题表现 #

已配置CORS，但访问函数URL返回：

Error: Forbidden
Your client does not have permission to get URL /app from this server.

解决方法 #

1. 添加匿名访问权限
   部署后的HTTPS函数默认要求身份验证，需通过runWith的运行时配置选项显式允许匿名访问：

   exports.app = functions.runWith({
     timeoutSeconds: 300,
     invoker: "public" // 允许所有匿名用户访问
   }).https.onRequest(/* ... */);
   

2. 升级依赖修复CORS冲突
   旧版本firebase-functions中CORS配置与权限设置存在兼容问题，升级到最新版可解决该冲突，同时同步升级firebase-admin到对应兼容版本。

内容的提问来源于stack exchange，提问作者Wim den Herder