手动构建含OFL参数的Dynamic Link URL在桌面浏览器无法正常工作

以下是针对你的问题的具体排查和修复步骤：

1. 检查Firebase控制台域名配置 #

• 确保你的动态链接域名（即代码中的prefix_url）已在Firebase控制台完成验证，并且配置了桌面端的跳转规则：
  进入Firebase控制台 → 动态链接 → 选择你的域名 → 查看高级选项，确认桌面行为设置为“重定向到指定URL”，并对应到你的目标网页地址。

2. 修正Firebase SDK构建短链的参数 #

你当前使用的otherPlatform.fallbackUrl并非针对桌面浏览器，该字段主要用于小众移动平台。桌面端跳转需要配置web专属字段：

await firebase.dynamicLinks().buildShortLink(
  {
    domainUriPrefix: `${prefix_url}`,
    link: `${prefix_url}/${params}`,
    android: {
      packageName: `${package_name}`,
    },
    ios: {
      bundleId: `${bundle_id}`,
      appStoreId: 'xxxxxxxxxx',
    },
    // 替换otherPlatform为web字段，专门处理桌面/网页端跳转
    web: {
      fallbackUrl: `${web_url}`,
      isFallbackForDesktop: true // 强制桌面直接跳转fallback，跳过应用安装提示
    },
  },
  firebase.dynamicLinks.ShortLinkType.UNGUESSABLE,
);

3. 修正手动构建长链接的参数 #

手动构建长链接时，ofl是iOS端的fallback参数，桌面端需要额外添加dfl（Desktop Fallback URL）参数，同时必须对所有URL参数进行编码：

longDynamicLink: `${prefix_url}/?link=${encodeURIComponent(link_url)}&apn=${package_name}&ibi=${bundle_id}&isi=xxxxxxxxx&ofl=${encodeURIComponent(web_url)}&dfl=${encodeURIComponent(web_url)}`,
suffix: {
  option: 'UNGUESSABLE',
},

未编码的特殊字符会导致链接解析失败，触发“无效动态链接”提示。

4. 验证链接有效性 #

使用Firebase控制台的动态链接诊断功能，输入生成的短链，查看是否存在配置错误（比如域名未验证、参数缺失等）。确保prefix_url是Firebase官方分配的域名（如xxx.page.link）或已完成验证的自定义域名。

5. 排除浏览器缓存干扰 #

桌面浏览器可能缓存了之前的错误响应，测试时使用无痕/隐私窗口打开链接，避免缓存影响结果。

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