Android 12下App Links手动验证不生效问题排查求助

开发者阿泽

2026-9-25

App Link Android12 适配修复方案

先修正Manifest配置：
给对应打开链接的intent-filter明确添加android:autoVerify="true"属性，且http/https协议的data标签要单独放在一个intent-filter中，不要和deeplink的自定义scheme混放，示例配置如下：

<intent-filter android:autoVerify="true">
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data android:scheme="https" android:host="你的域名" />
    <!-- 如果有子域名需要单独配置，不要把多个配置写在同一个data标签 -->
    <data android:scheme="https" android:host="*.你的域名" />
</intent-filter>

校验站点assetlinks.json配置：
文件必须放在https://你的域名/.well-known/assetlinks.json路径下，要求服务端返回200状态码、无重定向、Content-Type为application/json，文件内的SHA256指纹必须同时包含测试签名和正式发布签名的指纹，JSON格式严格合法无多余注释或转义字符。
手动触发验证排查问题：
执行adb命令手动触发验证：adb shell pm verify-app-links --re-verify 你的应用包名，执行后立刻查看验证结果：adb shell dumpsys package d | grep 你的应用包名。如果执行dumpsys命令没有对应输出，说明系统未识别到应用声明的App Link域名，优先检查Manifest中intent-filter的action、category配置是否完整，android:autoVerify属性是否添加正确；如果返回结果中状态为VERIFIED说明配置成功，为FAILED则需要重新核对域名和assetlinks.json配置。
定制ROM适配：
部分国内Android12及以上定制ROM会默认禁止未在应用商店上架的应用自动获得App Link验证权限，配置正确的前提下，测试阶段可以手动进入应用详情页的「默认打开」设置，开启对应域名的打开权限即可，正式上架应用商店后系统会自动完成验证授权。