Quasar Vite SSR配置Firebase Functions时处理函数不存在报错

问题背景 #

使用Quasar CLI创建的Vite配置Quasar V2 SSR应用，按文档配置Firebase Functions后，访问时提示Function us-central1-handler does not exist，但Webpack配置的同版本Quasar应用可正常运行。已完成firebase init、依赖安装、firebase.json配置、server.js编写及目录依赖安装等操作。

排查与解决步骤 #

1. 确认入口文件的导出格式 #

Firebase Functions默认解析CommonJS模块，而Vite默认可能输出ES模块，导致无法识别handler导出：

• 检查dist/ssr/index.js，确保最终导出语句为CommonJS格式：

  module.exports = handler;
  

• 如果你的server.js用了ES模块导出（export default handler），需要在Vite配置中强制输出CommonJS，或在构建后转换导出格式。

2. 调整Vite构建配置为CommonJS #

在项目根目录的quasar.config.js中修改SSR构建的Vite配置，指定输出格式为CommonJS：

module.exports = configure(function (ctx) {
  return {
    // ...其他配置
    build: {
      vite: {
        ssr: {
          format: 'cjs'
        }
      }
    }
  }
})

修改后重新执行构建：

quasar build -m ssr

3. 验证firebase.json配置正确性 #

确保firebase.json中functions的source路径和hosting重写规则正确：

{
  "functions": {
    "source": "dist/ssr"
  },
  "hosting": {
    "public": "dist/ssr/public",
    "rewrites": [
      {
        "source": "**",
        "function": "handler"
      }
    ]
  }
}

• 确认functions.source是相对项目根目录的正确路径，指向包含index.js和package.json的SSR构建目录。
• 若SSR静态资源目录不是dist/ssr/public，需对应修改hosting.public。

4. 检查dist/ssr目录的package.json #

确保dist/ssr/package.json的main字段指向正确的入口文件：

{
  "main": "index.js"
}

如果没有该字段，Firebase会默认查找index.js，但显式配置可避免路径识别问题。

5. 重新安装依赖并构建 #

• 删除dist/ssr/node_modules目录，避免旧依赖干扰。
• 进入dist/ssr目录，执行生产依赖安装：

  npm install --production
  

• 重新执行SSR构建，确保产物更新：

  quasar build -m ssr
  

6. 本地测试日志排查 #

运行firebase serve或firebase emulators:start时，查看终端输出：

• 若日志中无Function handler initialized相关内容，说明Firebase未识别到handler函数，需回到前面步骤检查导出和配置。
• 可直接在dist/ssr目录执行node index.js，查看是否有模块导出错误或其他运行时异常。

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