React Native中Firebase手机认证真机无法发送验证码

阿华AIGC实验室

2026-5-22

解决react-native-firebase手机认证收不到短信验证码的问题

作为刚接触React Native和react-native-firebase的开发者，遇到收不到验证码的情况确实挺让人头疼的，我来帮你梳理几个常见的排查方向：

1. 先确认手机号格式是否合规

signInWithPhoneNumber要求手机号必须是E.164标准格式，也就是带国家代码的完整号码——比如中国手机号要写成+8613xxxxxxxxx，不能只写13xxxxxxxxx，也不能带空格、括号这类额外符号。你可以在调用方法前先打印验证下格式：

console.log('当前提交的手机号:', phoneNumber);

2. 核对Firebase项目的认证配置

先去Firebase控制台的「Authentication」→「登录方法」里，确认「电话」登录方式已经启用，并且没有设置地区限制之类的规则；
检查项目的配置文件：Android的google-services.json和iOS的GoogleService-Info.plist是不是和Firebase控制台下载的完全一致，有没有放对项目目录。

3. 注意测试环境的限制

如果是用模拟器/模拟器测试，大概率收不到真实短信（尤其是iOS模拟器），建议直接用真实设备测试；另外Firebase提供了「测试号码」功能，你可以在控制台「Authentication」→「登录方法」→「电话」里添加测试号，这类号码不需要真实短信，调用接口后会返回固定验证码，适合开发阶段调试。

4. 补全代码的错误捕获逻辑

你提供的代码片段只到then((confirmResult) => { // 这意味着短信已...，建议加上.catch()捕获错误，很多时候报错信息能直接定位问题：

firebase.auth().signInWithPhoneNumber(phoneNumber)
  .then((confirmResult) => {
    console.log('短信发送请求已提交，返回结果:', confirmResult);
    // 这里记得保存confirmResult，后续输入验证码后要用它调用confirmResult.confirm(code)完成认证
  })
  .catch((error) => {
    console.error('发送短信请求失败:', error.message);
    // 比如invalid-phone-number是格式错误，operation-not-allowed是电话登录未启用
  });