Android Intent URL:browser_fallback_url 怎么用,不生效时怎么排查
intent:// 链接让 Android 上的 Chrome 打开你的应用,S.browser_fallback_url 告诉它打不开时该去哪里。本文给出三个可用示例,说明在各个浏览器里会发生什么,以及备用网址没有生效时该按什么顺序排查。
一条链接,在 Android 和 iPhone 上都能打开应用
- 自动生成 intent:// 和 myapp:// 链接
- 没装应用时跳到 App Store、Google Play 或你的网站
- 免费套餐,无需信用卡
简短回答
Android intent URL 里的 browser_fallback_url 是怎么起作用的?
S.browser_fallback_url 是 intent:// 链接里的一个附加参数:手机上没有能打开这个 intent 的应用,或者应用没有启动时,Android 上的 Chrome 就加载这个网址。它必须是完整的、经过百分号编码的 https 地址,而且 Chrome 只在用户真正点击后才处理这条链接,定时器、地址栏输入或从手动输入的地址重定向过来的都不行。
要点
- 备用网址要编码:intent 用分号分隔字段,没编码的 ; 或 # 会把它弄坏。
- 如果 package 或 scheme 和已安装的应用对不上,即使应用就在手机上,Chrome 也会加载备用网址。
- intent:// 只在 Android 上有效。iPhone 需要 Universal Links,应用内浏览器也常常忽略 intent 链接。
简短的回答
intent URL 是一种特殊链接:Android 上的 Chrome 不会把它当网页加载,而是交给某个应用处理。S.browser_fallback_url 是链接里的一个附加参数,指定一个网址:手机上没有能打开它的应用,或者应用没有启动时,Chrome 就加载这个网址。
Chrome 只在用户真正点击之后才处理 intent URL。由定时器触发、在地址栏里手动输入,或者从手动输入的地址重定向过来的链接,都不会有任何反应。大部分“备用网址不生效”的问题都出在这里。
拆解一条 intent URL
下面是深度链接生成器为一个 scheme 为 myshop 的购物应用生成的链接。
intent://product/42#Intent;scheme=myshop;package=com.example.myshop;S.browser_fallback_url=https%3A%2F%2F…;end
intent://product/42
主机和路径
应用收到的内容。配合下面的 scheme,就变成 myshop://product/42。
#Intent;
intent 开始
从这里到 end 都是给 Android 的指令,不属于地址本身。
scheme=myshop;
Scheme
必须和应用某个 intent filter 里声明的 scheme 一致。
package=com.example.myshop;
包名
应用的 application ID。只有这个应用可以打开这条链接。
S.browser_fallback_url=https%3A%2F%2F…;
备用网址
完整的 https 地址,经过百分号编码。Chrome 会先把它去掉,应用收到的 intent 里没有它。
end
结束
结束整个 intent。它前面的每个字段都以分号结尾。
三个可用示例
三条链接在装了应用时都会打开 myshop://product/42,区别在于没装应用时 Chrome 去哪里。
备用网址是网页
<a href="intent://product/42#Intent;scheme=myshop;package=com.example.myshop;S.browser_fallback_url=https%3A%2F%2Fexample.com%2Fproduct%2F42;end">
Open in the app
</a>备用网址是 Google Play
<a href="intent://product/42#Intent;scheme=myshop;package=com.example.myshop;S.browser_fallback_url=https%3A%2F%2Fplay.google.com%2Fstore%2Fapps%2Fdetails%3Fid%3Dcom.example.myshop;end">
Open in the app
</a>带推广 referrer 的 Google Play
<a href="intent://product/42#Intent;scheme=myshop;package=com.example.myshop;S.browser_fallback_url=https%3A%2F%2Fplay.google.com%2Fstore%2Fapps%2Fdetails%3Fid%3Dcom.example.myshop%26referrer%3Dutm_source%253Dnewsletter%2526utm_campaign%253Dspring;end">
Open in the app
</a>在不同地方打开会怎样
备用网址不生效:按这个顺序排查
大多数问题出在前三步。
确认有真实的点击
用真正的 <a href> 或点击事件处理函数。由定时器、页面加载或异步请求之后打开的链接会丢掉用户手势,Chrome 会直接忽略它,也不会加载备用网址。
从网页里测试,不要用地址栏
在地址栏输入 intent://,或者从你手动输入的地址跳转过去,都会被忽略。把链接放到一个测试页面上,再去点它。
解码备用网址
S.browser_fallback_url 必须是完整的 http 或 https 地址,并经过百分号编码。把它粘贴到解码工具里,确认还原出来的地址完整无缺,自带的查询参数也都在。
核对 package 和 scheme
如果 package 和已安装应用的 application ID 不一致,或者 scheme 不在它的任何 intent filter 里,Chrome 会认为 intent 无法解析,即使应用就在手机上,也会加载备用网址。
给 activity 加上 BROWSABLE
只有声明了 android.intent.category.BROWSABLE 的 activity 才能从网页启动。没有它,应用永远不会从 Chrome 打开。
绕开 Chrome 打开 URI
运行下面的 adb 命令。如果这里也打不开对应页面,问题出在应用的 intent filter,而不是链接。
在用户实际使用的浏览器里测试
Chrome、Samsung Internet,以及你的链接会被分享到的那些应用的内置浏览器。应用内浏览器检测工具可以告诉你页面是在哪个浏览器里打开的。
应用这一端
一个接受来自网页的 myshop://product/… 的 intent filter,以及在连接的手机上打开该 URI 的命令。
AndroidManifest.xml
<activity
android:name=".ProductActivity"
android:exported="true">
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="android.intent.category.BROWSABLE" />
<data android:scheme="myshop" android:host="product" />
</intent-filter>
</activity>终端
adb shell am start -W -a android.intent.action.VIEW \
-d "myshop://product/42" com.example.myshopIntent URL、App Links 和 iPhone
intent URL 只在 Android 上有效,而且只能用在你自己掌控的网页里。如果链接要投放到广告、邮件和社交平台,经过验证的 Android App Links 更可靠:一个 https 地址,装了应用就打开应用,没装就加载你的网站,整个判断过程不经过浏览器。
iPhone 要走自己的路:Universal Links,需要配置 apple-app-site-association 文件。一条链接如果要在两个平台和电脑上都能用,最后通常会变成一个 https 地址,由它为每种设备选择对应的路径。
Appy 能做什么
深度链接生成器根据你的 scheme、页面路径和应用商店链接,生成 intent URL 和 myapp:// 链接,再把它们合成一条 Appy 链接。在免费套餐中,这条链接会把 iPhone 送到 App Store,把 Android 手机送到 Google Play,把电脑送到你的网站;在 Pro 套餐中,它还能直接打开应用的对应页面,无需集成 SDK。
工具和术语解释
资料来源(2026 年 11 月 13 日查阅)
- Chrome for Developers · Android Intents with Chromedeveloper.chrome.com/docs/android/intents
- Android Developers · Create deep links to app contentdeveloper.android.com/training/app-links/deep-linking
- Android Developers · Verify Android App Linksdeveloper.android.com/training/app-links/verify-android-applinks
- Android Developers · Android Debug Bridge (adb)developer.android.com/tools/adb
常见问题
browser_fallback_url 为什么不生效?
通常是因为 Chrome 没有收到真实的点击:链接是由 JavaScript 打开的、在地址栏里输入的,或者是经过重定向到达的。其他常见原因是备用网址没有编码,以及 package 或 scheme 和应用对不上。
browser_fallback_url 需要做 URL 编码吗?
需要。intent 用分号分隔各个字段,地址里没编码的 ; 或 # 会把链接弄坏。Chrome 官方示例里用的也是百分号编码后的地址。
备用网址可以是 Google Play 链接吗?
可以。使用完整的 https://play.google.com/store/apps/details?id=… 地址,并做编码。如果要保留推广 referrer,先在 Play 网址里对 referrer 编码,再把整个 Play 网址作为备用网址编码一次。
应用明明装了,Chrome 为什么还是加载备用网址?
intent 没有解析成功:package 和应用的 application ID 不一致,scheme 或 host 不在任何 intent filter 里,或者 activity 没有声明 BROWSABLE。用 adb 测试这个 URI,就能分清是链接的问题还是应用的问题。
intent URL 在 iPhone 上能用吗?
不能。intent:// 是 Android 和 Chrome 的机制。iPhone 用的是 Universal Links,或者只在应用已安装时才有效的自定义 scheme。
继续探索
面向移动应用的 Dub.co 替代方案:不用跨过 $30 门槛的应用链接
Dub 是一个已经转型为联盟营销平台的网页短链工具。移动端排在后面:深度链接要 $30 的套餐,归因要 $90 的套餐,Android 归因至今没有上线,华为更是完全不支持。下面看看对应用团队来说,Appy 和它比起来如何。
如何在真机上测试 Google Play Install Referrer
从 Android Studio 装上的包读不到 install referrer。用内部测试渠道和编码好的 Play 网址拿到真实值,并看懂每种空值或异常值是什么原因。
邮件里的深度链接:点击追踪为什么会让它失效,又怎样两者兼得
营销邮件里的链接指向应用内的某个页面,用户一点,打开的却是你的网站。罪魁祸首是点击追踪。本文整理了截至 2026 年 10 月各家 ESP 文档里的说法、三种解决办法及各自的代价,还有一份在 iPhone 和 Android 上测试 Gmail、Apple Mail 和 Outlook 的方案。
想看更多内容?浏览 博客全部主题.