Swift中Branch创建无效链接：Safari提示无法打开页面

架构老林

2026-6-20

问题：Branch SDK生成的分享链接在Safari无法打开

我在Swift项目中使用Branch SDK创建应用分享链接，目的是用户分享后，他人通过链接下载应用，分享者可获得奖励。但代码生成的链接在Safari中打开时，提示“Safari无法打开页面，因为找不到服务器”。控制台创建的快速链接可以正常使用，但代码生成的链接和控制台生成的有差异。已确认iOS集成及链接配置正确，但Web端未配置，查官方文档也没解决问题，代码如下：

import Foundation
import Branch

class BranchService {
    static func createBranchLink(completion: @escaping (String?) -> Void) {
        let userID: Int = AuthService.shared.userID ?? 0
        let branchUniversalObject = BranchUniversalObject(canonicalIdentifier: "user/invite")
        branchUniversalObject.title = "xyz"
        branchUniversalObject.contentDescription = "abc"
        branchUniversalObject.contentMetadata.customMetadata = [
            "user_id": String(userID)
        ]

        let linkProperties = BranchLinkProperties()
        linkProperties.feature = "sharing"
        linkProperties.channel = "iOS"
        linkProperties.addControlParam("$desktop_url", withValue: "https://-.com/invite")
        linkProperties.addControlParam("$ios_url", withValue: "https://-.com/invite")
        linkProperties.addControlParam("$uri_redirect_mode", withValue: "0")


        branchUniversalObject.getShortUrl(with: linkProperties) { (url, error) in
            if error == nil, let url = url {
                completion(url)
            } else {
                completion(nil)
                print("Branch SDK Error: \(String(describing: error))")
            }
        }
    }
}

解决方案

修复无效跳转URL：代码中$desktop_url和$ios_url设置的https://-.com/invite是无效域名，这直接导致Safari无法找到对应服务器。控制台生成的有效链接必然配置了真实可访问的地址，你需要将这两个参数替换为实际可用的URL，比如你的官网邀请页面或App Store下载链接。
调整$uri_redirect_mode参数：将$uri_redirect_mode设为0会强制使用URI scheme跳转，若目标设备未安装你的App，又没有有效 fallback URL（当前配置的是无效地址），就会触发跳转失败。建议移除该参数，或根据需求改为合适的值（比如1代表智能跳转，会根据设备状态自动选择跳转方式）。
补充Web端配置：Branch链接的跳转逻辑依赖后台的Web配置来处理跨平台路由。控制台生成的链接会默认使用后台全局跳转规则，而代码中硬编码的跳转参数如果和后台配置冲突，或者后台未配置Web端基础路由，都会导致链接失效。需在Branch控制台补全Web端的跳转设置，确保链接能被正确解析。
对比链接参数差异：复制控制台生成的有效链接与代码生成的链接，对比两者的参数（如跳转地址、跳转模式等），找出代码中遗漏或错误的配置项，对齐控制台的有效配置逻辑。

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