Firebase Hosting部署后500错误：无法查找EJS视图文件

问题场景 #

• 本地Firebase Emulators运行正常，可访问localhost:5000/stores/KSP查看店铺数据
• 部署到Firebase Hosting后，访问对应路径出现500 Internal Server Error
• 函数日志报错：restApi: Error: Failed to lookup view "store" in views directory "/public/views"
• 已知将views移到functions目录可解决，但因store.ejs需引用public内静态资源，希望保留views在public目录

系统环境：

• node.js: v18.17.0
• npm: v9.8.1
• firebase: v12.4.6
• OS: Windows 11

可行解决方案 #

方案1：同步public目录到函数部署包

Firebase Functions默认仅部署functions目录下的文件，需通过配置让部署过程自动复制public目录到函数包中：

1. 修改项目根目录的firebase.json，添加函数预部署脚本：

{
  "functions": {
    "source": "functions",
    "ignore": [
      "node_modules/**",
      ".gitignore"
    ],
    "predeploy": [
      "mkdir -p functions/public && xcopy \"../public\" \"functions/public\" /E /Y"
    ]
  },
  "hosting": {
    // 保留原托管配置
  }
}

（注：Windows系统用xcopy，Mac/Linux替换为cp -r ../public/* functions/public/）

2. 调整functions/index.js中的路径配置，改为相对于functions目录的路径：

// 静态资源路径
app.use(express.static(path.join(__dirname, 'public')));
// 视图目录路径
app.set('views', path.join(__dirname, 'public/views'));

部署时，public目录会被复制到functions/public，云函数即可访问视图文件，同时EJS中引用的静态资源（如/css/style.css）仍由Firebase Hosting提供。

方案2：分离静态资源与动态路由（推荐）

遵循Firebase架构设计，静态资源由Hosting直接托管，动态请求转发到云函数，同时调整视图目录位置：

1. 移动目录：将public/views迁移到functions/views
2. 修改functions/index.js的视图配置：

app.set('views', path.join(__dirname, 'views'));

3. 更新firebase.json的托管重写规则，将动态路由转发到云函数：

"hosting": {
  "public": "public",
  "rewrites": [
    {
      "source": "/stores/**",
      "function": "restApi"
    },
    {
      "source": "/cart",
      "function": "restApi"
    }
  ]
}

此方法既解决视图访问问题，又利用Hosting的CDN性能优势，静态资源引用无需修改（保持绝对路径即可）。

方案3：排查部署后的实际路径

若不确定部署后的目录结构，可在云函数中添加日志输出路径信息：

console.log('当前工作目录:', process.cwd());
console.log('配置的views路径:', path.join(__dirname, '../public/views'));

部署后查看函数日志，确认实际路径是否与预期一致，再调整app.set('views', ...)的路径配置。

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