Firebase Auth自定义声明云函数部署失败问题求助

错误原因定位 #

报错TypeError: Cannot read properties of undefined (reading 'user')发生在模块加载阶段，说明代码解析时就出现了访问undefined对象的user属性的情况。结合你的代码和报错位置，核心诱因大概率是依赖版本不兼容或依赖未正确安装，少数情况是Node.js版本不满足要求。

解决方案 #

1. 检查并升级Node.js版本 #

Firebase Functions v4+要求Node.js 18或更高版本（LTS版本优先）：

• 运行node -v查看当前版本
• 若版本低于18，升级至Node.js 18/20 LTS版本

2. 彻底重置依赖 #

删除functions目录下的旧依赖文件，重新安装兼容版本：

1. 删除functions/node_modules文件夹和functions/package-lock.json文件
2. 运行以下命令重新安装依赖：

npm install firebase-functions@latest firebase-admin@latest

3. 确保package.json中依赖版本匹配（例如firebase-functions@4.x搭配firebase-admin@12.x）

3. 验证代码写法（可选优化） #

你的代码逻辑本身正确，可尝试显式解构参数避免潜在的对象访问问题，修改后的代码如下：

const functions = require('firebase-functions');
const { initializeApp } = require('firebase-admin/app');
const { getAuth } = require('firebase-admin/auth');

initializeApp();

exports.setAdminPrivilegesFalse = functions.auth.user().onCreate(async ({ email, uid }) => {
  if (email === 'example@email.com') {
    const customClaims = { admin: true };
    try {
      await getAuth().setCustomUserClaims(uid, customClaims);
      console.log(`User ${email} now has admin privileges`);
    } catch (error) {
      console.error('Error setting custom claims:', error);
    }
  }
});

4. 重置Firebase工具链 #

1. 更新全局firebase-tools：

npm install -g firebase-tools@latest

2. 重新登录Firebase：

firebase login

5. 本地预测试 #

部署前先启动模拟器验证代码是否正常：

firebase emulators:start --only functions

若模拟器能正常启动且无报错，再执行部署命令：

firebase deploy --only functions

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