Firebase认证报错求助：空reCAPTCHA令牌及邮箱格式错误问题

核心错误分析 #

从报错日志可明确两个关键问题：

1. 邮箱格式非法：日志中Creating user with demo123显示传入的用户标识是demo123，这不符合邮箱标准格式（必须包含@及域名后缀，如demo123@test.com），是触发The email address is badly formatted错误的直接原因。
2. reCAPTCHA Token为空：伴随警告empty reCAPTCHA token，需在修复邮箱问题后同步排查。

分步解决方案 #

• 修复邮箱格式问题
  确保调用Firebase注册接口时传入的邮箱参数符合RFC 5322标准格式，即包含@符号和有效的域名部分（如user@example.com）。直接使用纯字符串（如demo123）作为邮箱会触发格式校验失败。

• 处理空reCAPTCHA Token警告
  若修复邮箱后仍出现该警告，检查以下内容：

  • 登录Firebase控制台，进入「认证-登录方法」，确认密码登录的reCAPTCHA验证已正确启用。
  • 客户端代码中，确保RecaptchaVerifier（以Android为例）已正确绑定视图，且在调用createUserWithEmailAndPassword前完成了reCAPTCHA验证流程。
  • 核对Firebase Auth SDK版本，确保使用官方推荐的稳定版本，避免版本兼容问题导致的验证流程异常。

• 适配Firebase更新后的规范
  新版本Firebase Auth对校验逻辑做了严格升级，需确保代码调用符合最新规范：

  • 调用createUserWithEmailAndPassword(email, password)时，email参数必须是完整合法的邮箱字符串。
  • 若启用了App Check或reCAPTCHA Enterprise，需在客户端正确配置对应的验证密钥。

报错日志参考 #

/FirebaseAuth(17093): Creating user with demo123 with empty reCAPTCHA token
W/System  (17093): Ignoring header X-Firebase-Locale because its value was null.
E/RecaptchaCallWrapper(17093): Initial task failed for action RecaptchaAction(action=signUpPassword)with exception - The email address is badly formatted.

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