求助：Atlas Function依赖firebase-admin推送iOS通知失败报错

我尝试通过Atlas Function向iOS客户端推送通知，执行await admin.messaging().send(message);代码行时触发错误：
Error sending notification: FunctionError: TypeError: Value is not an object: undefined

函数代码 #

async function sendPushNotification(token, title, body) {
  const admin = require('firebase-admin');
  
  const credentials = {
    projectId: '<project id>',
    clientEmail: '<client email>',
    privateKey: '<private key>',
  };

  admin.initializeApp({
   credential: admin.credential.cert(credentials)
 });
 
 const message = {
    notification:{
      body: body,
      title: title
    },
    token: token
  };

  try {
    await admin.messaging().send(message);
    console.log('Notification sent successfully');
  } catch (error) {
    console.error('Error sending notification:', error);
  }
}

技术栈 #

• 基于Realm的SwiftUI应用
• 客户端集成Firebase Messaging
• Atlas Function依赖firebase-admin

已尝试的排查操作 #

• 打印admin、admin.messaging()和admin.messaging.send，均不为undefined
• 打印message、message.notification和message.token，也均不为undefined
• 将消息中的notification对象改为"data"，问题仍未解决

1. Firebase Admin重复初始化导致上下文异常 #

Atlas Function每次调用都会重新执行函数代码，重复调用admin.initializeApp()会触发初始化冲突，导致Firebase内部模块未正确实例化，进而抛出undefined相关错误。

解决办法：添加初始化判断，仅在无已初始化实例时执行初始化：

if (!admin.apps.length) {
  admin.initializeApp({
    credential: admin.credential.cert(credentials)
  });
}

2. 私钥格式错误 #

填入的<private key>未正确处理换行符，Firebase私钥包含多行格式，直接复制会丢失换行结构，导致admin.credential.cert()无法解析出有效凭证对象，最终引发messaging模块内部错误。

解决办法：用模板字符串包裹私钥，保留原始换行：

privateKey: `-----BEGIN PRIVATE KEY-----
your-actual-private-key-lines-here
-----END PRIVATE KEY-----`,

3. Firebase Admin版本兼容性问题 #

Atlas Function的Node.js运行环境可能与最新版firebase-admin存在适配问题，导致messaging方法内部调用异常。

解决办法：指定兼容的稳定版本，在Function的package.json中设置：

"dependencies": {
  "firebase-admin": "^11.11.0"
}

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