FlutterFire 项目中 Firebase 电话认证的计费变更解析

背景介绍

FlutterFire 是 Firebase 官方提供的 Flutter 插件集合，其中 firebase_auth 插件提供了包括电话认证在内的多种身份验证方式。近期许多开发者在使用 Firebase 电话认证功能时遇到了"BILLING_NOT_ENABLED"错误，这实际上是 Firebase 服务策略变更导致的。

问题现象

开发者在使用 firebase_auth 插件的 verifyPhoneNumber 方法进行电话认证时，系统返回错误信息"[firebase_auth/unknown] An internal error has occurred. [ BILLING_NOT_ENABLED ]"。这一现象在 Android 和 iOS 平台都会出现，但测试电话号码可以正常工作，而真实电话号码则无法通过验证。

根本原因

Firebase 在 2024 年 9 月 1 日实施了一项新政策：所有使用电话认证(SMS)功能的项目都必须关联到云计费账户。这意味着：

1. 即使是在 Spark 免费计划下，也必须启用计费功能才能使用电话认证
2. 虽然前 10 条短信/天仍然是免费的，但必须升级到 Blaze 计划并设置支付方式
3. 这一变更通过电子邮件通知了所有 Firebase 用户，但许多开发者可能没有注意到

解决方案

要解决这个问题，开发者需要完成以下步骤：

1. 登录 Firebase 控制台，进入项目设置
2. 升级项目到 Blaze 计划
3. 在 Google Cloud Platform 中为项目添加有效的支付方式
4. 等待计费配置生效（通常需要几小时，最多不超过24小时）

完成这些步骤后，电话认证功能将恢复正常，前10条短信/天仍然免费，超出部分才会产生费用。

技术实现细节

在 Flutter 应用中，电话认证的典型实现代码如下：

await FirebaseAuth.instance.verifyPhoneNumber(
  phoneNumber: '+82 ${phoneNumberController.text}',
  verificationCompleted: (credential) {
    // 验证成功处理
  },
  verificationFailed: (e) {
    // 验证失败处理
  },
  codeSent: (verificationId, resendToken) {
    // 验证码已发送处理
  },
  codeAutoRetrievalTimeout: (verificationId) {
    // 自动检索超时处理
  },
);

当计费未启用时，系统会在 verificationFailed 回调中返回 BILLING_NOT_ENABLED 错误。

注意事项

1. 即使升级到 Blaze 计划，前10条短信/天仍然是免费的
2. 支付方式添加后可能需要一段时间才能生效
3. 建议监控短信使用量，避免意外产生高额费用
4. 对于测试环境，可以继续使用 Firebase 控制台中配置的测试电话号码

替代方案

如果不想启用计费功能，开发者可以考虑以下替代方案：

1. 使用其他认证方式（如邮箱/密码、Google 登录等）
2. 在开发阶段使用测试电话号码
3. 实现自己的短信验证服务

总结

Firebase 电话认证的计费政策变更是开发者需要重视的变化。虽然增加了设置支付方式的步骤，但核心的免费额度仍然保留。开发者应及时调整项目配置，确保应用中的电话认证功能正常运行。对于新项目，建议在开发初期就完成计费设置，避免后期出现问题。