Branch IO Deep Link自定义别名无法跨应用共享，报409别名冲突如何解决？

你遇到的409错误是Branch IO的全局别名冲突规则导致的：自定义alias在你绑定的Branch应用域名（l.hire.in）下是唯一值，首次调用分享接口时已经成功创建了对应用户名的alias链接，后续再次触发分享操作时，代码重复向Branch发起了创建相同alias链接的请求，直接被服务端拒绝。

• 方案1：缓存已生成的分享链接
  首次成功生成用户的别名分享链接后，将链接存储在本地缓存或者你的后端用户数据表中，后续用户触发分享操作时，直接调用系统原生分享能力传入已存储的链接即可，不需要重复调用Branch的创建链接接口，从根源避免冲突。
• 方案2：冲突 fallback 逻辑
  如果需要复用Branch的分享弹窗能力，可以在接口返回409错误时，直接调用getShortUrl接口拉取已存在的别名链接完成分享，不需要重复创建。
• 方案3：预生成链接
  在用户注册生成唯一用户名的环节就预创建对应的Branch分享链接，存储到你的后端，后续所有分享场景直接拉取后端存储的链接使用，不需要在分享时动态传alias创建。

Future<void> buildBranchIOLink(ArtistModel artistModel) async {
  // 优先读取已缓存的分享链接
  final cachedLink = await getUserShareLinkFromCache(artistModel.uid); // 自行实现缓存/后端查询逻辑
  if (cachedLink != null) {
    // 直接调用系统分享即可，无需走Branch创建流程
    invokeNativeShare(cachedLink, artistModel.name);
    return;
  }

  BranchUniversalObject buo = BranchUniversalObject(
    canonicalIdentifier: '${artistModel.uid}',
    title: 'View my profile @${artistModel.name}',
    imageUrl: '',
    contentDescription: 'Visit A4H app for booking',
    keywords: ['Plugin', 'Branch', 'Flutter'],
    locallyIndex: true,
    contentMetadata: BranchContentMetaData()
      ..addCustomMetadata('artist_uid', '${artistModel.uid}')
  );

  String username = artistModel.systemName ?? artistModel.name;
  String processedAlias = username.replaceAll(" ", ".");

  BranchLinkProperties lp = BranchLinkProperties(
    alias: processedAlias,
    channel: 'message',
    feature: 'sharing',
    stage: 'new share',
    tags: ['one', 'two', 'three']);
  lp.addControlParam('url', 'http://www.google.com');
  lp.addControlParam('url2', 'http://flutter.dev');

  BranchResponse response = await FlutterBranchSdk.showShareSheet(
    buo: buo,
    linkProperties: lp,
    messageText: 'Hire ${artistModel.name} with A4H',
    androidMessageTitle: '${artistModel.name}',
    androidSharingTitle: '${artistModel.name}');

  if (response.success) {
    // 生成成功后缓存链接，下次分享直接用
    await saveUserShareLinkToCache(artistModel.uid, response.result); // 自行实现缓存/后端存储逻辑
    print('showShareSheet Success');
  } else {
    // 捕获409冲突，直接拉取已有链接分享
    if (response.errorCode == 409) {
      String existingLink = await FlutterBranchSdk.getShortUrl(buo: buo, linkProperties: lp);
      invokeNativeShare(existingLink, artistModel.name);
    }
    print('Error : ${response.errorCode} - ${response.errorMessage}');
  }

  bool success = await FlutterBranchSdk.listOnSearch(buo: buo);
  print(success);
}

• 自定义alias仅支持字母、数字、英文点、英文短横线，不要传入特殊字符避免创建失败
• 如果业务支持用户修改用户名，需要先在Branch后台删除旧的alias记录，再创建新用户名对应的alias链接，或者给旧别名配置重定向规则避免旧链接失效

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