react-native-firebase/auth调用sendSignInLinkToEmail未发送邮件链接问题

问题场景 #

集成@react-native-firebase/auth实现邮箱链接登录功能，已完成域名白名单配置，调用sendSignInLinkToEmail方法后目标邮箱始终未收到登录链接，全程无错误日志输出，对应调用代码如下：

const actionCodeSettings = {
  handleCodeInApp: true,
  url: Config.WEB_URL,
  iOS: {
    bundleId: APP_BUNDLE_ID,
  },
  android: {
    packageName: APP_BUNDLE_ID,
    installApp: true,
  },
};
await auth().sendSignInLinkToEmail(userEmail, actionCodeSettings);

排查步骤 #

1. 补全错误捕获，定位静默吞掉的异常 #

当前调用代码没有加异常捕获，部分版本的RN Firebase SDK不会把异步错误抛到全局，会直接静默吞掉，先把调用逻辑包裹进try/catch块，确认请求是否真的成功提交到Firebase后端：

try {
  await auth().sendSignInLinkToEmail(userEmail, actionCodeSettings);
  console.log('发信请求提交成功');
} catch (err) {
  console.log('发信异常：', err.code, err.message);
}

如果能打印出报错，直接根据错误码定位即可；如果打印了「发信请求提交成功」，继续往下排查。

2. 校验Firebase控制台配置 #

• 进入Firebase控制台Authentication > Sign-in method > 电子邮件链接板块，确认Config.WEB_URL对应的域名和白名单配置完全匹配，注意http/https协议、www前缀的差异都会触发后端静默拦截，不会返回前端错误。
• 检查同页面的「允许用户使用电子邮件链接登录/注册」开关是否开启，如果开关关闭，给不存在的用户发登录链接会被后端直接丢弃，无前端报错。
• 进入Authentication > Users页面，确认测试用的目标邮箱没有被禁用，禁用状态的用户无法收到登录邮件。
• 进入Authentication > 模板页面，查看顶部是否有当日发信配额耗尽的提示，Firebase免费版发信配额有限，配额耗尽后所有发信请求会被后端直接丢弃。在该页面点击发送测试邮件，输入目标邮箱，如果测试邮件也收不到，说明是发信通道问题，需要配置自定义发件域名，完成SPF、DKIM解析提升发信可信度，避免被邮箱服务商拦截。

3. 校验入参合法性 #

• 打日志确认传入的userEmail前后无多余空格、换行符，格式符合邮箱规范，非法格式的邮箱地址在部分SDK版本下不会触发明确报错。
• 校验actionCodeSettings参数：
  • url字段必须是http/https开头的完整公网可访问链接，不能传相对路径、自定义scheme
  • iOS的bundleId、Android的packageName必须和Firebase控制台对应应用注册的包名完全一致，大小写、字符差异都会导致后端校验不通过
  • 安卓配置下的installApp字段如果设为true，先临时改成false测试，部分SDK版本下如果应用未在对应应用商店上架，该参数会触发后端静默拦截。

4. 校验投递链路与运行环境 #

• 检查目标邮箱的垃圾邮件、推广邮件、订阅邮件文件夹，Firebase默认发件地址为noreply@<你的项目id>.firebaseapp.com，很容易被邮箱服务商判定为垃圾邮件。
• 打日志打印auth().app.options.projectId，确认当前App连接的Firebase项目和你配置白名单的项目一致，避免多环境切换时连错项目导致配置不生效。
• 确认测试设备网络可以正常访问Firebase服务，部分网络环境下请求被拦截、超时，老版本SDK不会抛出明确的网络错误。

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