Firebase云函数报错：Unreachable及Promise返回问题与推送通知代码故障

看起来你遇到了两个常见的Firebase Cloud Functions代码规范问题，我来帮你逐一拆解和修复：

1. 关于 each then() should return a value or throw promise/always-return 错误 #

这个是ESLint的强制规则，它要求Promise链里的每个then()回调必须返回一个值（可以是普通值或者另一个Promise），或者抛出一个错误。如果不这么做，Promise链会断裂，可能导致函数提前结束、资源泄漏，或者Firebase认为你的函数已经完成，但实际异步操作还在运行。

结合你的推送通知场景，很容易漏掉返回Promise。举个错误和正确的对比：

错误示例（会触发警告） #

exports.sendNotification = functions.database.ref('/notifications/{user_id}/{notification_id}').onWrite((change, context) => {
  const user_id = context.params.user_id;
  // 这里没return第一个Promise
  admin.database().ref(`/users/${user_id}/token`).once('value').then(snapshot => {
    const token = snapshot.val();
    const payload = {
      notification: { title: "New Alert", body: "You have a new notification" }
    };
    // 这里也没return发送通知的Promise
    admin.messaging().sendToDevice(token, payload);
  });
});

正确示例（修复返回值问题） #

'use strict' 
const functions = require('firebase-functions'); 
const admin = require('firebase-admin'); 
// 新版本Firebase推荐直接初始化，不需要传入functions.config().firebase
admin.initializeApp(); 

exports.sendNotification = functions.database.ref('/notifications/{user_id}/{notification_id}').onWrite((change, context) => { 
  const user_id = context.params.user_id;
  const notification_id = context.params.notification_id;

  // 1. return第一个Promise，开启完整的Promise链
  return admin.database().ref(`/users/${user_id}/token`).once('value').then(snapshot => {
    const token = snapshot.val();
    // 如果没有token，抛出错误终止链，避免无效操作
    if (!token) {
      throw new Error(`User ${user_id} does not have a notification token`);
    }

    // 构造通知内容
    const payload = {
      notification: {
        title: "New Notification",
        body: "You've received a new alert!",
        sound: "default"
      }
    };

    // 2. return发送通知的Promise，让链继续
    return admin.messaging().sendToDevice(token, payload);
  }).then(response => {
    // 可选：处理发送结果，这里返回null表示函数正常完成
    console.log(`Notification sent to user ${user_id}:`, response);
    return null;
  }).catch(error => {
    // 捕获错误并抛出，让Firebase记录错误日志
    console.error(`Failed to send notification to user ${user_id}:`, error);
    throw error;
  });
});

2. 关于 Unreachable 错误 #

这个错误表示代码里有一段逻辑永远不会被执行到，常见原因包括：

• 在return、throw语句之后还有代码（比如你在返回一个值后又写了console.log）
• 条件分支永远为真或假（比如if (1 === 2) { ... }里的代码）
• 你的代码片段里没写完的co...部分，可能是未完成的变量声明或逻辑，导致后续代码无法被解析到

建议你检查完整代码：

• 看看有没有在return/throw之后的冗余代码，把它们删掉
• 补全未完成的代码片段（比如co...应该是const notification_id = context.params.notification_id;？）
• 检查条件判断的逻辑，确保每个分支都是可达的

额外小提示 #

• 新版本的Firebase Admin SDK初始化不需要传入functions.config().firebase，直接调用admin.initializeApp()即可
• 可以用firebase deploy --only functions部署前，先在本地用firebase functions:shell测试代码，提前发现问题

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