使用Firebase Admin Node JS SDK解绑用户邮箱报格式错误的问题咨询

报错根因 #

这个报错是SDK对不同字段的校验逻辑差异导致的：

• 针对phoneNumber字段：SDK把传入的null值直接判定为“解绑手机号”的合法操作，校验流程识别到null值后会跳过格式校验，直接执行解绑逻辑，所以同类操作可以正常运行。
• 针对email字段：SDK没有为null值设置“解绑邮箱”的特殊校验分支。只要更新请求里携带了email这个参数键，不管传入什么值（哪怕是null），都会强制按照合法邮箱格式规则校验内容。null值完全无法匹配邮箱格式要求，自然就触发了The email address is improperly formatted的报错。

正确的操作流程 #

邮箱字段和密码登录渠道是深度绑定的，不能靠直接传email: null完成解绑，需要按照用户实际的登录配置调整操作：

• 如果当前用户的邮箱关联了密码登录方式（也就是可以用邮箱+密码完成登录）：
  调用updateUser时传入providersToUnlink: ['password']参数，先解绑对应的密码登录渠道，SDK会自动清空用户的关联邮箱字段，完全不需要手动传email: null。
• 如果用户只是额外关联了邮箱、没有开启邮箱密码登录：
  同样通过unlink对应关联渠道的参数完成解绑即可，不需要手动传email: null；如果需要手动修改邮箱值，必须传入符合格式要求的合法字符串，不能直接传null。

常见操作误区 #

很多人会在同一次更新请求里同时写email: null和password: null，觉得两个一起设空就能解绑，但实际上这两个参数的校验是独立的，就算传了password: null，也绕不开email字段的强制格式校验环节。

内容的提问来源于stack exchange，提问作者hakim homecent