Linux设备Node.js调用FCM获取Token遇PHONE_REGISTRATION_ERROR及UNIMPLEMENTED错误求助

排查与解决步骤 #

1. 校验依赖库兼容性与版本 #

你的代码同时依赖gcm和fcm相关库，而GCM已被FCM全面取代，旧版GCM库可能已停止服务，这是触发PHONE_REGISTRATION_ERROR的核心原因之一：

• 检查../gcm和../fcm依赖包的版本，若为老旧版本，尝试升级至最新兼容版；
• 若gcm库已废弃，直接移除GCM注册流程，改用FCM官方SDK完成Token注册。

2. 验证FCM项目配置与权限 #

• 登录Google Cloud控制台，确认对应Sender ID的项目中Firebase Cloud Messaging API处于启用状态；
• 检查项目API密钥是否有效，未被吊销或权限变更；
• 确认Sender ID与项目的绑定关系未被修改。

3. 测试设备网络对FCM端点的可达性 #

Linux设备需确保能正常访问FCM核心服务域名，执行以下命令测试连通性：

# 测试FCM注册端点
curl -v https://iid.googleapis.com/iid/v1:batchImport
# 测试旧GCM端点（若仍依赖）
curl -v https://android.googleapis.com/gcm/send

• 若请求被拦截，检查设备防火墙、代理配置，确保允许访问上述域名；
• 若DNS解析异常，可临时切换至Google DNS（8.8.8.8）重试。

4. 定位错误发生阶段 #

修改register函数，分别捕获GCM和FCM注册步骤的错误，明确问题源头：

async function register(senderId) {
  const appId = `wp:receiver.push.com#${uuidv4()}`;
  try {
    const subscription = await registerGCM(appId);
    console.log("GCM注册成功:", subscription);
  } catch(gcmErr) {
    console.error("GCM注册失败:", gcmErr);
    throw gcmErr;
  }
  try {
    const result = await registerFCM({
      token : subscription.token,
      senderId,
      appId,
    });
    console.log("FCM注册成功:", result);
    return Object.assign({}, result, { gcm : subscription });
  } catch(fcmErr) {
    console.error("FCM注册失败:", fcmErr);
    throw fcmErr;
  }
}

• 若错误集中在GCM阶段，直接放弃GCM流程，改用纯FCM注册；
• 若错误在FCM阶段，检查注册参数是否符合当前API要求。

5. 改用FCM官方SDK完成Token注册 #

如果旧自定义FCM注册库已不兼容，替换为Firebase官方Node.js SDK：

1. 安装依赖：

npm install firebase-admin

2. 客户端设备注册示例（需使用firebase库而非firebase-admin）：

const firebase = require('firebase/app');
require('firebase/messaging');

// 初始化App
firebase.initializeApp({
  senderId: "你的Sender ID"
});

async function getFCMToken() {
  const messaging = firebase.messaging();
  try {
    const token = await messaging.getToken();
    return { fcm: { token } };
  } catch (err) {
    console.error("FCM Token获取失败:", err);
    throw err;
  }
}

6. 调整appId格式 #

FCM对设备标识符有格式要求，尝试简化appId为类似Android包名的规范格式：

const appId = `com.push.receiver.${uuidv4()}`;

避免使用特殊符号或不符合规范的前缀，确保标识符唯一且通过FCM验证。

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