Flutter使用Email_auth包时因远程服务器初始化滞后无法优先发OTP邮件问题

问题场景 #

Flutter项目中引入email_auth包实现向用户邮箱发送OTP完成验证的功能，业务逻辑设定为用户打开邮箱认证页面时自动触发OTP发送操作，实际运行时无法通过自有远程服务器完成邮件发送。

运行日志 #

I/flutter (18523): email-auth >> Remote server is not available -- using test server --
I/flutter (18523): email-auth >> ❗ Warning this is not reliable on production
I/flutter (18523): email-auth >> OTP sent successfully ✅
I/flutter (18523): email-auth >> The remote server configurations are valid

根因定位 #

自有远程服务器初始化耗时过长，email_auth包发起OTP发送请求时，远程服务尚未完成初始化，包的降级机制会自动切换到测试服务器完成邮件发送，请求执行完成后远程服务器才完成初始化流程，因此日志末尾会提示远程配置有效。

解决方案 #

• 提前初始化时机：将远程服务初始化操作前置到应用启动阶段、或者邮箱认证页initState生命周期的最靠前位置，优先完成服务初始化再执行后续业务逻辑。
• 增加异步等待校验：给email_auth的配置初始化方法加await修饰，确认初始化完成后再调用OTP发送接口，参考实现代码：

// 等待远程配置初始化完成
await EmailAuth.config(
  remoteServer: "你的自有远程服务地址",
  // 其余配置参数
);
// 初始化完成后再触发OTP发送
await EmailAuth.sendOtp(receiverMail: "用户输入的邮箱地址");

• 增加初始化状态标记：维护单独的初始化完成状态位，只有状态位标记为初始化成功后，才触发自动发送OTP的逻辑，避免请求提前发出触发降级机制。

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