引入路由文件导致Firebase模拟器启动失败的原因排查

你的问题核心在于路由文件userRoutes.js混用了ES模块语法（import）和CommonJS语法（require），Firebase Functions默认以CommonJS模式解析代码，这种语法混用会导致Node.js解析失败，进而让Firebase无法正常分析函数代码，最终引发模拟器启动错误。

具体分析 #

主文件使用的是CommonJS的require语法，但userRoutes.js中存在import { getAuth... } from "firebase/auth"这类ES模块语法——Node.js不允许在同一代码环境中混合使用两种模块系统，哪怕你注释掉路由里的业务代码，只要文件里存在import关键字，就会触发解析错误，导致Firebase模拟器启动失败。

解决方案 #

方案1：统一使用CommonJS语法（适配Firebase默认配置，推荐）

将userRoutes.js中的所有import替换为require，保持与主文件一致的模块语法：

// Firebase imports
const { getAuth, signInWithPopup, GoogleAuthProvider } = require("firebase/auth");
const { initializeApp } = require("firebase/app");
const functions = require("firebase-functions");
const { firebaseConfig } = require("../firebase.js");

// Express imports
const express = require("express");
const router = express.Router();

console.log(firebaseConfig);

// Initialize Firebase
const app = initializeApp(firebaseConfig);
const provider = new GoogleAuthProvider();
const auth = getAuth(app);

router.get("/", (req, res) => {
    res.status(200).end();
});

module.exports = router;

方案2：切换为ES模块模式

如果偏好使用ES模块语法，需要全局统一配置：

1. 在项目根目录的package.json中添加"type": "module"
2. 将所有文件的模块语法统一为ES模块：
   • 主文件：把require改为import，module.exports改为export
   • userRoutes.js：保留import语法，将module.exports = router改为export default router

主文件修改示例：

import functions from "firebase-functions";
import express from "express";

const app = express();

app.set("views", "./pug-views");

import userRoutes from "./routes/userRoutes.js";
app.use("/user", userRoutes);

app.get("/lol", (req, res) => {
     res.status(200).send({ data: "It works hopefully" });
});

export const app = functions
    .region("europe-west1")
    .https.onRequest(app);

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