Outlook转发Firebase邮件链接认证URL丢失斜杠问题如何解决

问题诱因 #

该问题是微软系邮件客户端（Outlook、Windows Mail、Mac端Outlook）的已知URL解析缺陷导致：这类客户端在处理嵌套在URL查询参数内的其他HTTP/HTTPS链接时，会错误地将子链接协议头的双斜杠//判定为冗余路径分隔符，自动压缩为单斜杠/，最终导致动态链接的link参数失效。
你的场景中动态链接结构为https://appdev.page.link/?link=https://xxx，link参数值本身是完整HTTPS链接，刚好触发了该解析bug。

可行解决方案 #

不需要修改Firebase后台核心配置，通过以下任一方式即可修复：

1. 嵌套链接双重编码（最便捷，改代码即可） #

生成动态链接时，先对目标落地页链接做一次全量URL编码，让https://中的特殊字符转义为%3A%2F%2F，微软客户端就不会将其识别为可篡改的协议分隔符。
修改后的代码如下：

Future<void> sendSignInLinkToEmail(String email) async {
  final parameters = DynamicLinkParameters(
    uriPrefix: 'https://app.page.link',
    // 新增编码逻辑，对落地页链接做全量编码
    link: Uri.parse(Uri.encodeFull('https://app.de/signUp')),
    androidParameters: AndroidParameters(
      packageName: 'de.app.dev',
      minimumVersion: 100,
    ),
    iosParameters: IosParameters(
      bundleId: 'de.app.dev',
      minimumVersion: '1.0.0',
    ),
  );

  final dynamicUrl = (await parameters.buildShortLink()).shortUrl;

  final actionCodeSettings = ActionCodeSettings(
    url: dynamicUrl.toString(),
    handleCodeInApp: true,
    iOSBundleId: 'de.app.dev',
    androidPackageName: 'de.app.dev',
    androidInstallApp: true,
    androidMinimumVersion: '21',
  );

  return await _firebaseAuth.sendSignInLinkToEmail(
    email: email,
    actionCodeSettings: actionCodeSettings,
  );
}

该方案不影响原有跳转逻辑，Firebase动态链接服务可正常识别编码后的链接，自动解码跳转。

2. 动态链接路径映射（无参数依赖更稳定） #

在Firebase Dynamic Links后台配置短路径映射，比如将https://app.page.link/signup直接映射到落地页https://app.de/signUp，生成的动态链接本身不携带嵌套在查询参数内的HTTPS链接，从根源避免被客户端篡改。

3. 兼容兜底逻辑 #

在App处理登录链接的逻辑中新增校验：如果提取到的link参数值为https:/开头，自动补全为https://后再做后续校验，即使前两种方案未覆盖异常场景，也能保证链接可用。

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