如何通过Firebase向手机号和邮箱发送相同OTP？邮件OTP异常求助

一、核心问题说明 #

• Firebase 默认的手机号验证与邮箱验证是独立模块，无法直接生成跨渠道统一的OTP
• 邮箱收到的"字符串形式"内容，是因为Firebase默认邮箱验证发送的是验证链接而非数字验证码，需手动调整配置或自定义发送逻辑

二、实现统一OTP的具体方案 #

Firebase本身不支持跨渠道共享OTP，需自行生成统一OTP，再分别通过短信和邮箱发送，最后在客户端完成验证：

1. 生成自定义统一数字OTP #

生成符合验证码格式的6位数字OTP，并将其与过期时间（例：5分钟）存储到Firebase Firestore/Realtime Database，关联用户的手机号与邮箱：

// 生成6位随机数字OTP
func generateOTP() -> String {
    let otp = String(format: "%06d", Int.random(in: 100000...999999))
    // 存储OTP到Firebase，绑定用户手机号和邮箱
    guard let phone = phoneNumberTextField.text, let email = emailTextField.text else { return otp }
    let db = Firestore.firestore()
    db.collection("otps").document("\(phone)-\(email)").setData([
        "otp": otp,
        "expiresAt": Date().addingTimeInterval(300).timeIntervalSince1970
    ])
    return otp
}

2. 发送OTP到手机号 #

放弃Firebase自动发送短信的逻辑，改用Cloud Functions调用短信通道发送自定义OTP：

// 调用Cloud Functions发送自定义OTP到手机号
func sendOTPToPhone(otp: String) {
    guard let phoneNumber = phoneNumberTextField.text else { return }
    let functions = Functions.functions()
    functions.httpsCallable("sendSMS").call(["phoneNumber": phoneNumber, "otp": otp]) { result, error in
        if let error = error {
            print("短信OTP发送失败：\(error.localizedDescription)")
            return
        }
        print("短信OTP发送成功")
    }
}

3. 发送符合格式的OTP到邮箱 #

同样通过Cloud Functions发送自定义数字OTP，避免Firebase默认的链接形式：

// 调用Cloud Functions发送自定义OTP到邮箱
func sendOTPToEmail(otp: String) {
    guard let email = emailTextField.text else { return }
    let functions = Functions.functions()
    functions.httpsCallable("sendEmailOTP").call(["email": email, "otp": otp]) { result, error in
        if let error = error {
            print("邮箱OTP发送失败：\(error.localizedDescription)")
            return
        }
        print("邮箱OTP发送成功")
    }
}

4. 客户端验证OTP逻辑 #

用户输入验证码后，从Firebase存储中查询对应OTP，验证是否匹配且未过期：

func verifyInputOTP(inputOTP: String) {
    guard let phone = phoneNumberTextField.text, let email = emailTextField.text else { return }
    let db = Firestore.firestore()
    db.collection("otps").document("\(phone)-\(email)").getDocument { snapshot, error in
        guard let data = snapshot?.data(), 
              let storedOTP = data["otp"] as? String, 
              let expiresAt = data["expiresAt"] as? TimeInterval else {
            print("验证失败：OTP不存在")
            return
        }
        if storedOTP == inputOTP && Date().timeIntervalSince1970 < expiresAt {
            print("OTP验证成功")
            // 执行后续登录/注册流程
        } else {
            print("OTP无效或已过期")
        }
    }
}

三、快速解决邮箱OTP为字符串的问题 #

若不想自定义发送逻辑，可直接修改Firebase邮箱验证模板：

1. 进入Firebase控制台 → Authentication → 模板
2. 选择对应场景的模板（如"邮箱验证"或"密码重置"）
3. 将模板中的验证链接替换为{otp}变量，调整内容为数字验证码格式，例如：

你的验证码是：{otp}，5分钟内有效。

修改后，Firebase发送的邮箱内容将显示数字OTP而非链接。

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