Flutter集成Firebase发送邮箱登录链接时出现firebase_auth/internal-error

先获取精准错误信息 #

当前错误处理只打印了基础错误对象，Firebase Auth异常包含更详细的错误码和描述，修改错误处理函数来提取：

FutureOr<void> emailErrorHandler(Object error) {
  if (error is FirebaseAuthException) {
    log('Error code: ${error.code}, Detailed message: ${error.message}');
  } else {
    log('Error sending login email: $error');
  }
}

拿到具体错误码后，能更精准定位问题，比如unauthorized-domain、invalid-action-code-settings等。

针对性排查方案 #

1. 校验ActionCodeSettings配置 #

• 域名授权：确保https://www.politicsthegame.app已添加到Firebase控制台「认证」→「登录方法」→「邮箱/密码」的「授权域名」列表，建议同时添加不带www的域名（如果有）。
• 包名一致性：核对iOSBundleId和androidPackageName与Xcode项目、AndroidManifest.xml中的包名完全一致，大小写、拼写不能有任何偏差。
• Android最低版本限制：如果你的应用支持低于Android 12的设备，暂时移除androidMinimumVersion参数测试，或确保测试设备系统版本符合要求。

2. 重置Firebase配置文件 #

• 重新从Firebase控制台下载google-services.json（Android）和GoogleService-Info.plist（iOS），替换项目中旧文件，然后清理缓存：
  • Android：执行flutter clean后重新构建
  • iOS：删除Pods文件夹，执行pod install，再用Command+Shift+K清理Xcode缓存

3. 简化配置测试 #

先去掉平台相关配置，测试基础功能是否正常：

void clickLogin() {
  ActionCodeSettings actionCodeSettings = ActionCodeSettings(
      url: 'https://www.politicsthegame.app',
      handleCodeInApp: false); // 先关闭APP内处理
  FirebaseAuth.instance
      .sendSignInLinkToEmail(
          email: emailController.text, actionCodeSettings: actionCodeSettings)
      .then(emailSent)
      .catchError(emailErrorHandler);
}

如果这一步成功，说明是iOS/Android平台配置项出了问题，再逐个添加参数排查。

4. 基础项检查 #

• 确认emailController.text是合法邮箱格式，Firebase会拒绝无效邮箱请求
• 用全新邮箱测试，排除目标邮箱因违规、封禁等异常状态导致的问题
• 检查Google Cloud Console中API密钥的限制：HTTP限制需包含你的域名，Android限制要填对包名和SHA-1指纹（debug和release指纹都要加），iOS限制要匹配Bundle ID

5. 其他排查点 #

• 升级pubspec.yaml中firebase_auth到最新稳定版，旧版本可能存在已知bug
• 确保测试设备/模拟器网络正常，没有被代理或防火墙拦截Firebase请求

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