Swift应用中自定义Firebase重置密码邮件内容及本地化实现

核心原因 #

Firebase Auth默认的重置密码邮件正文是在Firebase控制台的模板里定义的，你设置Auth.auth().languageCode或者调用useAppLanguage()，只会本地化邮件里的链接部分，没法覆盖控制台模板里的正文内容。

可选解决方案 #

方案1：配置Firebase多语言邮件模板 #

• 登录Firebase控制台，进入Authentication > 模板页面
• 找到「密码重置」模板，点击添加语言，把你需要的语言（比如西班牙语）加上
• 给每种语言单独写对应的正文内容，保存之后，Firebase会自动根据用户设置的languageCode匹配对应语言的模板
• 优点：不用改App代码，直接在控制台配置；缺点：所有语言的模板都得手动维护

方案2：完全自定义重置密码邮件（适合需要高度定制的场景） #

要是你想直接在App里控制邮件内容（比如用本地硬编码的多语言文本），可以跳过Firebase自动发邮件的流程，自己生成重置链接然后发自定义邮件：

1. 生成密码重置链接
   在Swift里调用Firebase的接口生成重置链接：

import FirebaseAuth

func getPasswordResetLink(email: String, completion: @escaping (String?, Error?) -> Void) {
    Auth.auth().generatePasswordResetLink(withEmail: email) { link, error in
        completion(link, error)
    }
}

2. 准备本地多语言文本
   用App的本地化字符串文件（Localizable.strings）存不同语言的邮件内容：

• 西班牙语es.lproj/Localizable.strings：

  "reset_pwd_subject" = "Restablece tu contraseña";
  "reset_pwd_body" = "Haz clic en el enlace para restablecer tu contraseña: %@";
  

• 中文zh-Hans.lproj/Localizable.strings：

  "reset_pwd_subject" = "重置你的密码";
  "reset_pwd_body" = "点击以下链接重置密码：%@";
  

3. 发送自定义邮件
   用App内的邮件组件（比如MFMailComposeViewController）或者后端服务发邮件，把生成的链接插到本地化后的正文里：

import MessageUI

func sendCustomResetEmail(to email: String) {
    getPasswordResetLink(email: email) { [weak self] link, error in
        guard let self = self, let resetLink = link, error == nil else {
            // 处理生成链接失败的情况
            return
        }
        
        if MFMailComposeViewController.canSendMail() {
            let mailVC = MFMailComposeViewController()
            mailVC.mailComposeDelegate = self
            mailVC.setToRecipients([email])
            mailVC.setSubject(NSLocalizedString("reset_pwd_subject", comment: ""))
            let mailBody = String(format: NSLocalizedString("reset_pwd_body", comment: ""), resetLink)
            mailVC.setMessageBody(mailBody, isHTML: false)
            
            self.present(mailVC, animated: true)
        } else {
            // 提示用户无法发送邮件，或者调用后端API来发
        }
    }
}

// 实现邮件控制器的代理方法
extension YourViewController: MFMailComposeViewControllerDelegate {
    func mailComposeController(_ controller: MFMailComposeViewController, didFinishWith result: MFMailComposeResult, error: Error?) {
        controller.dismiss(animated: true)
    }
}

注意事项 #

• 用方案2的话，要么确保用户设备能发送邮件，要么自己搭后端服务处理邮件发送，避免App内发邮件失败的情况
• 自定义生成的重置链接有效期和Firebase默认的一样，由控制台的设置控制

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