Flutter：Firebase重置密码链接打开应用而非网页及相关异常求助

1. 让密码重置链接直接跳转网页 #

默认Firebase动态链接会优先唤起应用，要改这个行为，有两个可行方案：

• 修改Firebase邮件模板：
  1. 打开Firebase控制台，进入「Authentication」→「模板」
  2. 找到密码重置模板，编辑它的「操作URL」
  3. 替换为网页端的密码重置地址（比如你托管在Firebase或自有服务器的重置页面，不要用默认动态链接）
• 代码中自定义action URL：
  在SignInScreen的EmailAuthProvider里指定网页地址，关键是把handleCodeInApp设为false：

  SignInScreen(
    showAuthActionSwitch: true,
    providers: [
      EmailAuthProvider(
        actionCodeSettings: ActionCodeSettings(
          url: "https://your-domain.com/password-reset", // 你的网页重置地址
          handleCodeInApp: false, // 强制链接跳转网页
          androidInstallApp: false,
          iOSBundleId: "your.ios.bundle.id",
        ),
      ),
    ],
  );
  

2. 修复应用无法识别DynamicLink的问题 #

如果之后需要用动态链接唤起应用并处理，需确保全链路配置正确：

• 原生端配置：
  • Android：在AndroidManifest.xml的主Activity中添加intent-filter，配置你的动态链接域名；同时在Firebase控制台上传assetlinks.json到域名根目录。
  • iOS：在Xcode中开启「Associated Domains」，添加applinks:your-dynamic-link-domain；并在Firebase控制台配置iOS的Bundle ID和Team ID。
• Flutter端监听链接：
  安装firebase_dynamic_links包，在应用初始化时监听链接：

  import 'package:firebase_dynamic_links/firebase_dynamic_links.dart';
  
  void initDynamicLinks() async {
    // 处理冷启动时的链接
    final PendingDynamicLinkData? data = await FirebaseDynamicLinks.instance.getInitialLink();
    final Uri? deepLink = data?.link;
    if (deepLink != null && deepLink.path.contains('passwordReset')) {
      final code = deepLink.queryParameters['oobCode'];
      // 跳转到应用内密码重置页面，用code完成重置逻辑
    }
  
    // 处理应用运行时的链接
    FirebaseDynamicLinks.instance.onLink.listen((dynamicLinkData) {
      final Uri deepLink = dynamicLinkData.link;
      if (deepLink.path.contains('passwordReset')) {
        final code = deepLink.queryParameters['oobCode'];
        // 处理重置逻辑
      }
    }).onError((error) {
      // 捕获链接处理错误
    });
  }
  

  记得在main函数中调用initDynamicLinks()。

3. 解决重复应用实例的问题 #

这是Android启动模式配置导致的，修改AndroidManifest.xml：
找到主Activity的配置项，将launchMode改为singleTask：

<activity
    android:name=".MainActivity"
    android:launchMode="singleTask"
    ...>
    <!-- 其他原有配置 -->
</activity>

这样点击链接时会复用已有的应用实例，不会创建新进程。

另外，之前自定义域名未生效，大概率是Firebase控制台未完成域名验证，或原生端配置未同步更新，需先在Firebase控制台的「Dynamic Links」模块添加并验证自定义域名，再同步修改原生端配置。

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