---
title: "Android App Links 验证失败：用 adb 五分钟定位 | Appy"
description: "App Link 在浏览器而不是应用中打开？这份 adb 排查清单能快速找到原因，包括大多数事故背后的 Play 签名密钥不匹配问题。逐项核对 assetlinks.json、包名和 SHA-256 指纹，区分 Play App Signing、上传密钥与本地签名，再重新验证域名和设备跳转结果。"
source: "https://appy.to/zh/blog/android-app-links-verification-failed"
---

[← 返回博客](https://appy.to/zh/blog)

故障排查

# Android App Links 验证失败：用 adb 五分钟定位问题

从 Android 12 起，域名验证未通过的 App Link 会在浏览器而非你的应用中打开——静默发生，而且并非每台设备都一样。这份 adb 排查清单能快速找到原因，包括大多数事故背后的 Play 签名密钥不匹配问题。

2026年8月14日•阅读约 10 分钟

用 AI 总结[ChatGPT](https://chatgpt.com/?q=%E8%AF%B7%E6%80%BB%E7%BB%93%E8%BF%99%E4%B8%AA%E9%A1%B5%E9%9D%A2%E5%B9%B6%E5%88%97%E5%87%BA%E8%A6%81%E7%82%B9%EF%BC%9A%20https%3A%2F%2Fappy.to%2Fzh%2Fblog%2Fandroid-app-links-verification-failed) [Claude](https://claude.ai/new?q=%E8%AF%B7%E6%80%BB%E7%BB%93%E8%BF%99%E4%B8%AA%E9%A1%B5%E9%9D%A2%E5%B9%B6%E5%88%97%E5%87%BA%E8%A6%81%E7%82%B9%EF%BC%9A%20https%3A%2F%2Fappy.to%2Fzh%2Fblog%2Fandroid-app-links-verification-failed) [Perplexity](https://www.perplexity.ai/search?q=%E8%AF%B7%E6%80%BB%E7%BB%93%E8%BF%99%E4%B8%AA%E9%A1%B5%E9%9D%A2%E5%B9%B6%E5%88%97%E5%87%BA%E8%A6%81%E7%82%B9%EF%BC%9A%20https%3A%2F%2Fappy.to%2Fzh%2Fblog%2Fandroid-app-links-verification-failed)

简短回答

## Android App Links 为什么在浏览器里打开，而不是打开我的应用？

从 Android 12 起，只有系统在安装时验证过你的域名，https 链接才会打开你的应用；验证失败时，这次点击会被静默地送进浏览器。最常见的原因是 assetlinks.json 里填的是上传密钥的指纹，而不是 Play 应用签名密钥的指纹。用 adb shell pm get-app-links 查看状态。

要点

-   assetlinks.json 必须通过 HTTPS 直接返回 200，Content-Type 为 application/json；验证器不跟随重定向。
-   修好文件后，运行 adb shell pm verify-app-links --re-verify；部分三星设备还需要重启。
-   通常不用更新应用：只要 manifest 里用 autoVerify 声明了这个域名，在服务器端修就行。

## 应用装着，链接却打开了 Chrome

它通常以工单而非报错的形式出现。用户点了指向你域名的链接，应用就在手机上，打开的却是 Chrome。按 Android 文档的说法，从 Android 12 起，https 链接只有在系统于安装时验证过你的域名后才会打开应用——而验证失败时是静默失败。没有崩溃，没有提示，仪表盘里什么也看不到。

有两个特性让排查格外痛苦。验证按域名进行：example.com 可能已验证，promo.example.com 却悄悄没有。它还按设备进行：同一个构建在 Pixel 上通过，在三星手机上却失败——三星开发者论坛的帖子里反复出现这种组合。如果你正处在事故当中，直接跳到下面的诊断部分。

## 两个域名，两种裁决

adb · Android 16

$ adb shell pm get-app-links com.example.app

com.example.app:

Domain verification state:

example.com: verified

promo.example.com: none

打开应用打开浏览器

出事之前没人会读的输出：example.com 在安装时通过了验证，promo.example.com 从未通过。每个裁决都在设备上静默作出。

## 安装时到底发生了什么

应用安装或更新时，Android 会读取每个用 autoVerify 声明的域名，并逐一抓取 https://你的域名/.well-known/assetlinks.json。按 Android 文档，该文件必须以 HTTPS 直接返回 200，content type 为 application/json——验证器不跟随重定向。结果按域名缓存，这就是为什么一个子域名已验证、它的兄弟却没有。

文件里的 sha256\_cert\_fingerprints 必须匹配设备上 APK 的签名证书。头号陷阱来了：启用 Play App Signing 后，那个证书是 Google 的应用签名密钥——不是你的上传密钥。本地 keystore 的指纹能完美验证手动安装的构建，却会让每一次来自 Play 商店的安装失败。「在我设备上是好的」的报告里，一半都追溯到这里。

开始前还要知道一点：裁决会被缓存。修好服务器上的 JSON，对已经失败的手机毫无作用，直到验证再次运行——幸好这可以强制触发。

在你修复验证的这段时间里，Pro 套餐的 Appy 链接无需 App Links 就能打开已安装的 App，其他人则被送往 Google Play；由于跳转目标可以更改，已印刷的二维码也照常可用。

应用安装或更新

Android 读取每个用 autoVerify 声明的域名

为每个域名抓取 assetlinks.json

/.well-known/assetlinks.json

1.  01

通过 HTTPS 直接返回 200

HTTP 200

失败原因： 301 或 302 重定向、404、登录墙或机器人校验

2.  02

以 JSON 格式返回

content-type: application/json

失败原因： text/html 或 text/plain，即使正文有效

3.  03

包名已列出

com.example.app

失败原因： 数组里缺少某个 flavor 或包名

4.  04

指纹与已安装的应用一致

sha256\_cert\_fingerprints

失败原因： 只有上传密钥，没有 Play 签名密钥


verified：链接打开应用

按域名保存在这台设备上

none：链接打开浏览器

静默发生，没有崩溃，仪表盘里也毫无痕迹

裁决会被缓存。文件修好后，已经失败的手机在验证再次运行前不会有任何变化，所以要强制重新验证。

Android 在安装时对每个 autoVerify 域名检查的项目。任何一项失败，都足以把该域名送去浏览器。

## 五分钟诊断

接上任意一台装有应用的 Android 12+ 设备，按顺序执行。多数事故在第三步就能解决。

01

### 读取验证状态

`adb shell pm get-app-links com.example.app`

这条命令打印应用声明的每个域名及其状态。verified 表示握手通过；none 表示验证器从未批准该域名——把用户送去 Chrome 的正是它。多用户设备上，也要检查输出底部按用户划分的部分。

02

### 像验证器那样抓取 assetlinks.json

`curl -sI https://example.com/.well-known/assetlinks.json`

你要看到直接的 200。任何 301 或 302 都会让验证失败——按 Android 文档，验证器不跟随重定向。确认 content-type 是 application/json，然后抓取正文，亲眼核对包名和指纹。/.well-known/ 前面的反爬或登录墙同样算失败。

03

### 对照 Play 签名密钥核对指纹

`Play Console → App integrity → App signing key certificate`

打开 Play Console 的这个页面，把上面的 SHA-256 和你的 JSON 放在一起。必须逐字节一致。如果文件里是上传密钥的指纹，问题就找到了——加入 Play 签名密钥指纹；如果还在 Play 商店之外分发构建，两个都保留。

04

### 强制重新验证

`adb shell pm verify-app-links --re-verify com.example.app`

修好服务器端后，让设备再试一次。验证器是异步运行的：等几秒，重复第一步，观察 none 变成 verified。部分三星设备的状态要重启后才会变——三星开发者论坛报告过这一模式。

05

### 像真实点击一样触发 intent

`adb shell am start -a android.intent.action.VIEW -d "https://example.com/promo"`

这是端到端测试。已验证的域名会直接打开应用，没有选择器。如果出现浏览器或选择弹窗，说明状态还没翻转——先复查第一步，再下结论说修复失败。

如果不想在事故中肉眼核对 JSON，我们的 [链接校验工具](https://appy.to/zh/tools/universal-link-validator) 会抓取你的 assetlinks.json，一次性检查状态码、content type 和指纹格式。

## 常见元凶

五个原因覆盖了我们见过的几乎所有报告。左边原因，右边修法。

手动安装的构建

用你的上传密钥签名

上传密钥

assetlinks.json

文件中列出的指纹

上传密钥

匹配：verified

从 Google Play 安装

用 Google 的应用签名密钥签名

Play 签名密钥

assetlinks.json

文件中列出的指纹

上传密钥

不匹配：none

Play 签名密钥上传密钥

修法：从 Play Console → App integrity → App signing key certificate 添加 SHA-256。如果还分发用上传密钥签名的构建，两个指纹都保留。

为什么在你的手机上正常、在用户那里失败：文件里是上传密钥的指纹，而每一次来自 Play 商店的安装都用 Google 的密钥签名。

原因修法

JSON 里是上传密钥指纹，而不是 Play 签名密钥

从 Play Console → App integrity → App signing key certificate 复制 SHA-256。如果还分发上传密钥签名的构建，两个指纹都保留。

assetlinks.json 返回重定向或 404

在每个声明的主机上直接以 /.well-known/assetlinks.json 提供文件。对验证器来说，www 和裸域是两个不同的域名。

错误的 content type，如 text/html 或 text/plain

配置服务器或 CDN 对该路径返回 application/json。正文再正确，头错了照样失败。

多个 flavor 或包名，文件里缺了一个

这个文件是数组：每个包名一条声明，各带自己的指纹。缺了哪个 flavor 就只有那个失败，在 QA 里看起来像随机故障。

修好 JSON 后三星设备仍停在 none

部分三星机型的延迟验证在三星开发者论坛是常客。先强制重新验证，再重启设备，然后才下别的结论。

## Android 15 和 16 改了什么

最近两个版本把标准朝同一个方向推进：受支持的路径是经过验证的 https App Links，其余的路都在收窄。

Android 15

按平台发行说明，加入了 Dynamic App Links：域名关联可以在不发布新 APK 的情况下更新，缩短了从修好 JSON 到设备生效之间的周期。

Android 16

按平台发行说明，收紧了自定义 URI scheme 的验证方式。如果你的流程还依赖 myapp:// 这类 scheme，把它们当作遗留方案，把入口迁到已验证的 https 链接上。

## Appy 链接能帮上忙的地方

智能链接在服务器上完成路由，先于上述所有机制：有人打开 Appy 链接时，重定向读取设备信息，把 Android、iOS 和桌面访客送往不同目的地。这套路由在所有套餐可用，也不依赖设备端验证——因为它发生在操作系统看到你的域名之前。

故障期间，变的是用户点的那条链接。Appy 链接先经过 Appy 的跳转，所以它打开什么不由 App Links 验证决定：在 Pro 上，跳转会用带有你包名的 intent:// 链接打开已安装的应用，没装应用的手机则去 Google Play。直接指向你自己域名的链接，在验证通过之前仍会在浏览器中打开。动态二维码印出后仍可修改，所以印刷的码也可以走同一条路，分析数据会显示这段时间来了多少 Android 流量。

无论如何都要修好验证，因为你自己域名上的链接、邮件里的链接和分享菜单里的链接仍然依赖它。在那之前，Pro 上的 Appy 链接会继续打开应用，Enterprise 的延迟深度链接会把目的地带过安装过程。

有人点击你的链接

appy.to/promo

服务器端

重定向识别设备

Android、iOS 和桌面端分别前往不同目的地，所有套餐均可用

iOS 和桌面端：各自的目的地

手机端

Android 落到你的 https 域名

操作系统这时才看到你的域名

手机端

Android 按验证状态处理

verified：应用none：浏览器

修复 assetlinks.json 期间

AndroidPlay 商店页面你的网站

把 Android 流量指向 Play 商店页面或你的网站，修好后再切回来。已印刷的二维码依然有效。

智能链接在操作系统介入之前就决定每台设备去哪里。它无法绕过验证：在你的域名上，打开应用还是浏览器，仍由 verified 或 none 决定。

## 常见问题

### 为什么同一条链接在一台设备上正常，在另一台上不行？

验证在每台设备的安装时各自运行，所以每部手机都带着自己缓存的裁决。安装时的网络波动、行为不同的 OEM 验证器——三星是其开发者论坛上被报告最多的案例——或早于你修复 JSON 的安装，都会让同一构建呈现不同状态。

### 需要发应用更新才能修复吗？

通常不需要。如果 manifest 已用 autoVerify 声明了域名，故障就在 JSON 文件或指纹里，都在服务器端。修好文件、强制重新验证，已安装的构建就会开始打开链接。只有域名从未在 manifest 里声明时才需要更新。

### 智能链接能绕过 App Links 验证吗？

不能——对任何相反的说法都要警惕。重定向在服务器端选择目的地，但访客一落到你的 https 域名，操作系统就照常应用同样的验证状态。智能链接改变的是验证坏掉期间你能做什么——导向商店或网页——而不是它坏没坏。

### 验证多久会自己重试？

按 Android 文档，验证器会重试失败的域名，并在应用更新时重新运行，但时间表没有保证，各 OEM 也不同。实际上是数小时到数天。用 adb 强制重新验证，或重装应用，都比干等快。

## 继续探索

故障排查

2026年10月9日

9 分钟阅读

### Universal Links 与 App Links 错误码详解

SWCERR00101、SWCERR00301、legacy\_failure 和 1026 分别是什么意思、在哪里能看到，以及怎样修复，让 Universal Links 和 App Links 重新打开你的应用。

universal links

app links

apple-app-site-association

assetlinks.json

[阅读文章](https://appy.to/zh/blog/universal-link-app-link-error-codes)

指南

2026年10月15日

7 分钟阅读

### 应用、应用商店还是网站：链接的点击到底去了哪里

智能链接如何决定每位访问者的去向，为什么 WhatsApp 和 Slack 的链接预览不算点击，以及怎样看懂 Appy 的新数据，不被表面数字骗了。

link analytics

bot traffic

link previews

unique visitors

[阅读文章](https://appy.to/zh/blog/smart-link-clicks-app-store-website-bots)

指南

2026年10月9日

12 分钟阅读

### 应用内浏览器如何处理深度链接：Instagram、TikTok、Facebook、Gmail、Telegram 等

同一条链接，在 Safari 里能打开应用，到了 Instagram 里就失灵。本文梳理每个应用用的是哪种浏览器、Apple、Google 和 Chrome 的规则，以及你能做些什么。

in-app browser

universal links

app links

instagram

[阅读文章](https://appy.to/zh/blog/in-app-browser-deep-links)

想看更多内容？浏览 [博客全部主题](https://appy.to/zh/blog).

## 给 Android 流量一个落脚点

创建一条在服务器端识别设备的智能链接，把 Android 访客送往应用、商店或网页——之后随时改目的地，一张二维码都不用重印。

[免费创建智能链接](https://appy.to/zh/account/register)
