在Supabase中更新已认证用户：Flutter下如何获知邮箱确认点击状态

方法一：监听Auth状态流 #

利用Supabase提供的authStateChanges()流，实时监听用户身份状态的变化。当用户点击邮件中的确认链接完成邮箱更新后，用户会话会自动刷新，用户对象里的邮箱字段会同步更新为新邮箱。你可以在应用初始化或相关功能页面订阅这个流：

supabase.auth.authStateChanges().listen((AuthState state) {
  if (state.event == AuthChangeEvent.userUpdated) {
    final currentUser = state.session?.user;
    if (currentUser?.email == newEmail) {
      // 这里执行邮箱确认后的逻辑，比如弹窗提示用户、跳转至个人中心等
    }
  }
});

方法二：主动查询用户信息 #

当用户从邮件客户端切回应用时，主动调用Supabase的用户信息查询接口，对比当前邮箱是否已更新为目标邮箱。可以结合Flutter的应用生命周期监听，在用户回到应用时触发检查：

// 先实现WidgetsBindingObserver监听应用生命周期
class _YourWidgetState extends State<YourWidget> with WidgetsBindingObserver {
  @override
  void initState() {
    super.initState();
    WidgetsBinding.instance.addObserver(this);
  }

  @override
  void didChangeAppLifecycleState(AppLifecycleState state) {
    super.didChangeAppLifecycleState(state);
    if (state == AppLifecycleState.resumed) {
      // 应用回到前台，检查邮箱状态
      _checkEmailUpdateStatus();
    }
  }

  Future<void> _checkEmailUpdateStatus() async {
    try {
      final userResponse = await supabase.auth.getUser();
      if (userResponse.user?.email == newEmail) {
        // 邮箱已确认更新
      }
    } catch (e) {
      // 处理查询异常
    }
  }

  @override
  void dispose() {
    WidgetsBinding.instance.removeObserver(this);
    super.dispose();
  }
}

方法三：通过Deep Link直接触发校验 #

在Supabase控制台的邮箱模板中，将确认链接的域名替换为你的应用Deep Link（例如yourapp://verify-email）。用户点击链接后会直接打开应用，你可以在Deep Link的处理逻辑中立即检查邮箱状态：

1. 按照iOS和Android平台的官方文档配置应用的Deep Link；
2. 在路由逻辑中处理Deep Link回调：

// 示例使用go_router处理Deep Link
GoRoute(
  path: '/verify-email',
  builder: (context, state) {
    // 触发邮箱状态检查
    _checkEmailUpdateStatus();
    return const EmailVerificationSuccessPage();
  },
);

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