React Native Firebase 项目中 iOS 设备上手机号验证的 Invalid Token 问题解析与解决方案

问题背景

在 React Native Firebase 项目中，开发者经常使用手机号验证功能来实现用户认证。然而，在 iOS 真实设备上运行时，可能会遇到一个特定的错误："[auth/invalid-app-credential] Invalid token"。这个错误通常不会出现在模拟器或 Android 设备上，使得问题更加棘手。

问题表现

当调用 auth().signInWithPhoneNumber(phoneNumber) 方法时，开发者可能会观察到以下现象：

• 在 iOS 模拟器上工作正常
• 在 Android 真实设备和模拟器上工作正常
• 但在 iOS 真实设备上会抛出 "[auth/invalid-app-credential] Invalid token" 错误

根本原因分析

经过深入调查，这个问题通常与以下因素有关：

1. Firebase 库版本不一致：项目中不同 Firebase 模块使用了不兼容的版本组合，特别是当 auth 模块与其他模块版本差距较大时。

2. iOS 设备特有的认证机制：iOS 设备上的 Firebase 认证需要正确的 APNs 配置，但错误往往不是由 APNs 配置本身引起的。

3. Kotlin 版本冲突：当尝试升级 Firebase 库来解决 iOS 问题时，可能会在 Android 端引入 Kotlin 版本不兼容的问题。

解决方案

第一步：统一 Firebase 库版本

确保项目中所有 Firebase 相关库使用相同的主要版本。例如：

"@react-native-firebase/app": "^20.5.0",
"@react-native-firebase/auth": "^20.5.0",
"@react-native-firebase/firestore": "^20.5.0",
"@react-native-firebase/functions": "^20.5.0",
"@react-native-firebase/storage": "^20.5.0"

避免出现类似 auth 使用 20.5.0 而 functions 使用 21.6.0 的情况。

第二步：处理 Android 端的 Kotlin 版本问题

升级 Firebase 库后，可能会遇到 Android 构建错误，提示 Kotlin 版本不兼容。解决方法如下：

1. 在 android/build.gradle 中设置 Kotlin 版本为 2.0.21：

ext {
    kotlinVersion = "2.0.21"
}

2. 确保 Gradle 插件和其他相关依赖与 Kotlin 版本兼容。

第三步：验证 iOS 配置

虽然 APNs 配置通常不是问题的根源，但仍需确保：

1. Firebase 控制台中已正确配置 iOS 应用
2. 已上传 APNs 认证密钥（如果需要推送通知）
3. iOS 项目的 Capabilities 中已启用推送通知

最佳实践建议

1. 保持依赖版本一致：定期检查并更新所有 Firebase 相关库到相同的最新稳定版本。

2. 分步测试：在实现手机号验证功能时，先在模拟器上测试基本功能，再在真实设备上进行全面测试。

3. 构建环境管理：使用类似 rnfbdemo 这样的标准构建演示项目作为参考，确保基础配置正确。

4. 错误监控：实现完善的错误监控机制，捕获并分析生产环境中的认证错误。

总结

React Native Firebase 的手机号验证功能在 iOS 设备上的 "Invalid token" 错误通常源于版本不一致问题。通过统一 Firebase 库版本、正确处理 Kotlin 依赖关系，并验证 iOS 配置，开发者可以有效地解决这个问题。记住，在 React Native 开发中，保持所有相关依赖的版本一致性是避免许多跨平台问题的关键。