Flutter应用深度链接为何跳转浏览器而非应用内路由？

Android端（singleTask模式下无法唤起应用） #

• 检查intent-filter覆盖范围：当前仅配置了pathPrefix="/join/"，但测试链接还包含/details，需为/details单独添加一组intent-filter，确保所有需唤起应用的路径都被覆盖。
• 验证assetlinks.json有效性：
  • 确认服务器返回该文件时的Content-Type为application/json（可通过浏览器开发者工具查看响应头）
  • 检查sha256值完全匹配（注意大小写、无多余空格，需与Firebase配置完全一致）
• 处理singleTask模式下的Intent：在主Activity中重写onNewIntent方法，确保接收到深度链接Intent时，正确传递给GoRouter处理路由跳转，示例代码：

  override fun onNewIntent(intent: Intent?) {
      super.onNewIntent(intent)
      intent?.data?.let { uri ->
          // 将uri传递给Flutter侧的GoRouter处理
          // 例如通过MethodChannel发送事件
      }
  }
  

• 清除模拟器缓存：删除应用、重启模拟器，或在应用设置中清除“默认打开方式”缓存，避免旧配置干扰。

iOS端（Universal Links无法唤起应用） #

• 验证apple-app-site-associated文件：
  • 确保文件为严格JSON格式（无语法错误，如逗号、括号闭合）
  • 确认teamId和bundleId与苹果开发者账号、应用配置完全匹配，路径["*"]正确覆盖所有目标链接
  • 检查服务器返回该文件的Content-Type为application/json，且访问时无重定向（直接返回200状态码）
• 重置设备缓存：删除应用后重启模拟器/真机，iOS会缓存Universal Links配置，重启后才能加载新配置
• 确认Xcode配置：
  • 检查Associated Domains中是否正确添加applinks:bbtechnologies.org
  • 确保签名用的Provisioning Profile包含Associated Domains权限（真机测试时尤为重要）

通用排查点 #

• 检查GoRouter深度链接配置：确保路由定义中正确处理深度链接的路径参数，比如/join/:profileId的路由已设置pathParameters，且初始化时能正确解析传入的URI
• 测试链接正确性：使用实际有效的profileId链接（如https://bbtechnologies.org/join/123）测试，避免直接用占位符:profileId
• 确认设备权限：在设备设置中，确保应用被允许“从URL启动”，未禁用相关权限

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