Firebase Functions部署失败：解析函数触发器时触发ERR_PACKAGE_PATH_NOT_EXPORTED错误

看起来你踩了Firebase版本升级后的一个常见坑——这个错误的核心原因是Firebase v9+改用了ES模块（ESM）的导出结构，但你的代码还是用CommonJS的require()语法直接导入firebase包，两者不兼容。而且更重要的是：在Cloud Functions这种服务器端环境里，你根本不需要用客户端的firebase包，用firebase-admin就能搞定所有后端操作，还更安全。

下面给你一步步的解决办法：

1. 移除不必要的客户端firebase包 #

你已经安装了firebase-admin，服务器端的用户创建、数据操作完全可以用它实现，客户端firebase包在这里是多余的。执行以下命令卸载它：

npm uninstall firebase

2. 修改index.js代码，用firebase-admin实现用户注册 #

把原来依赖firebase的代码全部替换成firebase-admin的写法——注意firebase-admin在Cloud Functions环境里不需要手动传入firebaseConfig，云端会自动读取项目配置，本地开发也会通过你登录的Firebase账号自动关联配置。修改后的代码如下：

const app = require("express")();
const functions = require("firebase-functions");
const admin = require("firebase-admin");

// 初始化admin，不需要手动传配置
admin.initializeApp();

app.post('/signup', async (req, res) => {
  const newUser = {
    email: req.body.email,
    password: req.body.password,
    confirmPassword: req.body.confirmPassword,
    handle: req.body.handle
  };

  // 先做密码一致性校验，避免不必要的请求
  if (newUser.password !== newUser.confirmPassword) {
    return res.status(400).json({ error: "Passwords do not match" });
  }

  try {
    // 用admin的auth模块创建用户
    const userRecord = await admin.auth().createUser({
      email: newUser.email,
      password: newUser.password,
      displayName: newUser.handle
    });
    return res.status(201).json({ 
      message: `User ${newUser.handle} created successfully`,
      uid: userRecord.uid 
    });
  } catch (err) {
    console.error(err);
    return res.status(500).json({ error: err.code });
  }
})

exports.api = functions.https.onRequest(app);

3. 如果你非要保留firebase包（不推荐） #

如果你因为某些需求必须用客户端firebase包，那得用Firebase v9提供的兼容CommonJS的compat版本来导入：

// 替换原来的const firebase = require('firebase');
const firebase = require('firebase/compat');
const firebaseConfig = {...};
firebase.initializeApp(firebaseConfig);

但还是强烈建议你用firebase-admin，它是专门为后端设计的，拥有服务器级别的权限，不需要暴露敏感的API密钥，更适合Cloud Functions场景。

4. 重新部署函数 #

最后执行部署命令就可以了：

npm run deploy

作为刚接触Firebase+Express的新手，记得分清客户端和服务器端SDK的区别：firebase是给前端网页/APP用的，firebase-admin是给后端/Cloud Functions用的，后者能帮你更安全高效地处理后端逻辑。

内容的提问来源于stack exchange，提问作者Jarliev Pérez