Firebase Dynamic Links ofl参数失效及桌面回退链接配置求助

一、ofl参数被标记disallowed的核心原因 #

1. 域名未授权：Firebase动态链接要求桌面回退链接的域名必须添加到项目控制台的「动态链接」→「授权域名」列表中，未授权的域名会被判定为不安全链接。
2. 协议不符合要求：除了本地测试用的localhost，桌面回退链接必须使用HTTPS协议，HTTP链接会被直接拦截。
3. URL编码不规范：如果ofl参数值未做完整URL编码，或者编码过程中丢失了参数（比如token），会导致Firebase无法正确解析链接结构，触发安全拦截。
4. 链接内容被标记为危险：如果桌面回退链接被Google安全数据库标记为恶意、钓鱼类内容，也会被判定为disallowed。

二、正确配置ofl参数的步骤 #

1. 先完成基础配置检查 #

• 登录Firebase控制台，进入动态链接模块，把桌面回退链接的域名添加到「授权域名」列表。
• 确保桌面回退链接使用HTTPS协议（测试环境可临时用localhost）。

2. 规范构造长动态链接 #

长动态链接的核心结构必须包含必要的平台参数+ofl参数，所有参数值都要做URL编码：

https://<你的动态链接域名>/link?link=<编码后的核心APP链接>&ofl=<编码后的桌面回退链接>&apn=<Android包名>&ibi=<iOS Bundle ID>

示例（已编码）：
假设你的动态链接域名为your-domain.page.link，核心APP链接是https://yourapp.com/app?token=xyz-123，桌面回退链接是https://yourapp.com/desktop?token=xyz-123，则构造后的长链接为：

https://your-domain.page.link/link?link=https%3A%2F%2Fyourapp.com%2Fapp%3Ftoken%3Dxyz-123&ofl=https%3A%2F%2Fyourapp.com%2Fdesktop%3Ftoken%3Dxyz-123&apn=com.yourapp.android&ibi=com.yourapp.ios

3. 修复token传递问题 #

• 确保核心link参数和ofl参数里的token都正确编码，不要遗漏参数符号（?、&、=）。
• 不要单独拆分token参数，要把包含token的完整链接进行编码后再作为参数值。

4. 测试与验证 #

• 先直接访问带d=1参数的长链接（比如https://your-domain.page.link/link?d=1&...），查看预览页面的提示：如果仍有disallowed，预览页会给出具体原因（比如域名未授权），针对性修复。
• 预览页面确认正常后，再通过REST API生成短链接，请求负载仅包含构造好的longDynamicLink即可。

三、常见避坑点 #

• 不要省略apn（Android）、ibi（iOS）参数：Firebase需要这些参数识别平台类型，否则可能忽略ofl参数的配置。
• 编码时要用标准URL编码：避免手动拼接时出现字符转义错误，可使用Python的urllib.parse.quote工具完成编码。
• 测试阶段优先用长链接排查问题：短链接生成后难以直接定位参数错误，先确保长链接功能正常再生成短链接。

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