如何在Flutter中为Firebase Authentication构建自定义邮件操作处理程序

基础规则说明 #

• 不需要在Flutter路由中配置带参数的完整URL，只需要将/usermgmt（或者你自定义的路径）配置给Firebase作为操作处理程序URL即可，Firebase生成邮件链接时会自动拼接所有需要的查询参数。
• 带参数访问返回404的核心原因是静态托管平台默认没有配置单页应用（SPA）重定向规则，需要在你的托管服务后台配置所有请求 fallback 到Flutter Web的入口index.html，让Flutter的路由系统接管路径解析，而不是让托管平台直接查找对应路径的静态资源。

已验证的路由实现方案 #

你贴出的onGenerateRoute实现逻辑是完全可行的，核心思路是把传入的路由名称先解析为Uri对象，只匹配路径部分、忽略查询参数，再从Uri的queryParameters属性中取出需要的参数做业务处理，适配你的场景的代码如下：

onGenerateRoute: (settings) {
  Widget? authPage;
  if (settings.name != null) {
    var uriData = Uri.parse(settings.name!);
    // uriData.path为路径部分，uriData.queryParameters存储所有查询参数
    print("查询参数: " + uriData.queryParameters.toString());
    switch (uriData.path) {
      case '/usermgmt':
        authPage = AuthHandlerPage();
        break;
    }
  }
  if (authPage != null) {
    return MaterialPageRoute(
        builder: (BuildContext context) => authPage!);
  }
},

后续业务处理提示 #

拿到查询参数后，可以根据mode字段判断操作类型，常见的取值包括resetPassword（重置密码）、verifyEmail（邮箱验证）、recoverEmail（恢复邮箱），再配合oobCode调用Firebase Auth对应的接口完成操作即可。

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