AWS Lambda中Firebase Admin SDK的messaging.send()超时问题求助

算力阿峰

2026-7-3

问题

在AWS Lambda函数中使用以下代码实现FCM消息推送，代码逻辑本身正常，但服务器日志显示admin.messaging().send()函数经常触发超时（超过Lambda的60秒时长限制），触发超时后Lambda会自动重试。本地环境测试该流程时，消息推送可成功完成且耗时通常不超过1秒。请问该问题的成因是什么？如何解决？

export async function sendEnquiryMessage(messagingEvent: MessagingEvent, fcmToken: string) {

    let content = {
        title: `new Message from ABC`,
        body: `'${messagingEvent.message?.text ?? ""}' `,
    };

    console.log("sending a message to FCM: ", fcmToken);
    const message = {
        notification: {
            body: content.body,
            title: content.title,
        },
        data: {
            clickaction: 'FLUTTER_NOTIFICATION_CLICK',
            id: '1',
            status: 'done',
            messagingEvent: JSON.stringify(messagingEvent),
        },
        apns: {
            payload: {
                aps: {
                    'mutable-content': 1,
                    'content-available': 1
                }
            }
        },
        token: fcmToken,
    };
    console.log("MESSAGE TO SEND: ", JSON.stringify(message));
    try {
       const messageId = await admin.messaging().send(message);
        console.log("MESSAGE SENT messageId ID was : ", messageId);
    } catch (e) {
        console.error('Error FCM message:', e);
    }
    return true;
}

可能成因

Lambda冷启动延迟：如果Lambda函数长时间未被调用，会触发冷启动，初始化Firebase Admin SDK的过程可能耗时较长，导致整个请求超时。
Firebase SDK连接复用问题：Lambda的执行环境可能存在连接未正确复用的情况，每次调用都重新建立与FCM服务器的连接，增加了请求耗时。
Lambda资源配置不足：分配的内存/CPU资源过少，导致SDK运行效率低下，处理请求的时间被拉长。
FCM服务端区域延迟：Lambda所在AWS区域与FCM服务器的物理距离过远，网络传输耗时增加，极端情况下可能触发超时。
无效FCM Token处理：当推送目标是无效/过期的FCM Token时，FCM服务器可能会进行额外的校验或返回延迟，导致请求耗时超出Lambda限制。

解决方案

优化Firebase SDK初始化：将Firebase Admin SDK的初始化逻辑移到Lambda函数的全局作用域（函数体外），这样冷启动时只初始化一次，后续复用执行环境时无需重复初始化。
调整Lambda资源配置：适当提高Lambda的内存分配（比如从默认的128MB提升到512MB或更高），Lambda的CPU资源会随内存比例增加，提升运行效率。
启用Lambda预热：通过CloudWatch Events定期调用Lambda函数，保持执行环境处于暖状态，避免冷启动延迟。
设置请求超时时间：在Firebase SDK中设置合理的请求超时（比如10秒），避免等待FCM服务器过长时间，同时在代码中捕获超时异常，防止Lambda整体超时。
批量处理与错误过滤：提前过滤无效的FCM Token，避免向无效Token发送请求；如果有大量推送需求，改用批量推送接口admin.messaging().sendAll()减少请求次数。
选择就近的AWS区域：将Lambda部署到与FCM服务器物理距离更近的AWS区域（比如us-central1），降低网络传输延迟。

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