Firebase动态链接未安装应用时无法跳转至Play Store问题排查

核心现象对应的潜在问题 #

你遇到的浏览器闪跳+未安装时不跳转Play Store，大概率是App Links验证失败或Firebase动态链接配置错误导致的：系统无法识别链接归属你的应用，只能 fallback 到浏览器处理；未安装时的跳转逻辑则直接关联动态链接控制台的配置。

分步调试方法 #

1. 核对Firebase动态链接控制台配置

• 打开Firebase控制台的动态链接页面，检查目标链接的「未安装应用时的行为」：确认已选择「打开应用商店」，并填写与应用完全一致的包名（com.myapp）和Play Store应用ID（可从Play Console复制）
• 检查「深度链接」的域名是否和Manifest里的android:host="myapp.com"完全匹配，注意大小写、域名后缀的拼写细节

2. 验证App Links的autoVerify有效性

你的Manifest里添加了android:autoVerify="true"，但必须配合网站根目录的.well-known/assetlinks.json文件才能生效：

• 用adb命令强制重新验证App Links：

  adb shell pm verify-app-links --re-verify com.myapp
  

• 查看输出结果，如果显示「未通过验证」，说明myapp.com域名下未正确放置assetlinks.json，系统无法确认链接归属，只能走浏览器流程

3. 查看Firebase动态链接的详细日志

开启调试日志，捕捉跳转过程中的错误信息：

• 先设置日志级别：

  adb shell setprop log.tag.FirebaseDynamicLinks VERBOSE
  

• 点击动态链接后，用以下命令过滤日志：

  adb logcat -s FirebaseDynamicLinks
  

• 重点关注日志中的错误提示，比如「链接解析失败」「Intent路由被拦截」「App Links验证未通过」等，直接定位问题根源

4. 直接测试Intent唤起行为

跳过动态链接中间页，测试应用能否直接响应深度链接：

• 用adb发送测试Intent：

  adb shell am start -W -a android.intent.action.VIEW -d "你的深度链接（如https://myapp.com/xxx）" com.myapp
  

• 如果能直接打开应用，说明是动态链接中间页的配置问题；如果仍跳浏览器，说明Manifest的Intent Filter或App Links配置存在问题

5. 核对Play Store应用关联

• 确认Play Console里的应用包名，与Manifest、Firebase控制台配置的包名完全一致（大小写、字符均不能出错）
• 若应用未发布到Play Store（含内部测试版），动态链接可能无法正确触发Play Store跳转，建议先上传测试版本

针对当前Manifest配置的补充检查 #

你的Manifest中Deep Linking Intent Filter无明显语法错误，但需确认：

• 没有其他Activity的Intent Filter与当前配置冲突（比如其他Activity也声明了相同的host/scheme）
• 若动态链接使用了自定义路径，需在Intent Filter中添加<data android:pathPrefix="/xxx" />来匹配对应路径

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