如何将OneSignal API与Firebase Cloud Functions集成实现推送通知

我之前也折腾过把OneSignal推送迁移到Firebase Cloud Functions，确实因为环境特殊踩了点小坑，不过整体流程是通的，给你一步步拆解下：

1. 先搞定依赖安装 #

在你的Cloud Functions项目根目录下，直接用npm安装OneSignal的Node.js SDK就行，这个SDK是纯HTTP封装，完全适配Cloud Functions的Node环境：

npm install onesignal-node --save

2. 安全配置OneSignal凭证 #

别把OneSignal的API密钥和App ID硬编码在代码里，用Firebase的环境变量来存更安全。打开终端执行这两个命令：

firebase functions:config:set onesignal.api_key="你的OneSignal REST API密钥" onesignal.app_id="你的OneSignal应用ID"

之后在代码里就能这样读取配置：

const functions = require('firebase-functions');
const OneSignal = require('onesignal-node');

// 从Firebase环境变量拉取OneSignal配置
const oneSignalCreds = functions.config().onesignal;
const oneSignalClient = new OneSignal.Client(oneSignalCreds.app_id, oneSignalCreds.api_key);

3. 编写触发推送的Cloud Function #

接下来就可以根据你的业务场景写函数了，比如监听实时数据库的新通知节点来自动发推送，或者做HTTP触发的接口。举个数据库触发的例子：

// 当实时数据库的/notifications节点新增数据时，自动发推送
exports.sendPushOnNewNotification = functions.database.ref('/notifications/{notifyId}')
    .onCreate(async (snapshot, context) => {
        const notifyData = snapshot.val();
        
        // 构建OneSignal的推送内容
        const pushMessage = new OneSignal.Message({
            contents: {
                en: notifyData.contentEn,
                zh: notifyData.contentZh // 支持多语言的话可以加上
            },
            include_player_ids: [notifyData.targetPlayerId], // 目标用户的OneSignal Player ID
            headings: { en: notifyData.titleEn }
            // 还能加更多配置，比如跳转链接、自定义数据字段等
        });

        try {
            const sendResult = await oneSignalClient.sendNotification(pushMessage);
            console.log('推送发送成功:', sendResult.body);
            return null;
        } catch (err) {
            console.error('推送失败:', err);
            throw err; // 抛出错误让Cloud Functions记录日志
        }
    });

4. 注意Cloud Functions的环境细节 #

• 超时时间：默认函数超时是60秒，如果是批量发送推送，可能需要调长到最大的540秒（9分钟），在firebase.json里配置：

{
  "functions": {
    "runtimeOptions": {
      "timeoutSeconds": 540
    }
  }
}

• 网络权限：Cloud Functions默认允许对外请求，所以不用额外配置网络规则，直接调用OneSignal的API就行。
• 版本兼容：确保安装的onesignal-node版本和你用的Node.js runtime兼容（Cloud Functions现在支持Node 16/18/20，选对应版本的SDK就行）。

5. 测试与排错 #

部署函数后，可以通过Firebase控制台的函数测试功能，或者直接往数据库的/notifications节点加一条数据来触发推送。如果失败了，用firebase functions:log命令看日志，常见问题比如API密钥错了、Player ID无效、推送内容格式不对这些，查日志都能很快定位。

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