Android 13中get-app-links返回状态码1024的解决方法

问题背景 #

在Android 13设备上配置深度链接后，访问对应网站无法启动应用。已尝试常规教程中的配置，问题仍存在。

排查操作 #

执行adb命令查看应用链接状态：

adb shell pm get-app-links com.where44444.cleanbook

返回结果：

com.where44444.cleanbook:
    ID: 0892ecd5-a93b-4064-bb2c-5d6cae6e7ac6
    Signatures: [9D:F7:97:FE:92:94:1A:67:96:80:D4:07:84:F8:42:8E:96:50:2B:C2:2D:CC:19:AD:0F:CC:F1:A4:E0:72:39:BE]
    Domain verification state:
      cleanassistant.net: 1024
      www.cleanassistant.net: 1024

官方文档说明 #

错误码为1024或更高

设备验证器特有的自定义错误码。

请再次检查网络连接，重新触发域名验证流程。

已确认电脑和手机网络正常，需进一步解决方案。

解决方案 #

• 强制重新触发域名验证
  执行以下adb命令刷新应用的域名验证状态，之后重启应用测试：

  adb shell pm clear-domain-preferences com.where44444.cleanbook
  

• 检查assetlinks.json文件正确性

  • 确保文件放置在域名的.well-known目录下（如https://cleanassistant.net/.well-known/assetlinks.json）
  • 验证文件内的应用包名、签名哈希与设备返回的签名一致：将签名中的冒号移除并转为小写，例如9D:F7:...:BE转为9df797fe92941a679680d40784f8428e96502bc22dcc19ad0fccf1a4e07239be
  • 用浏览器直接访问该文件，确认能正常加载，无404或权限问题

• 校验AndroidManifest.xml配置
  确保深度链接的<intent-filter>包含android:autoVerify="true"，且<data>标签的scheme和host配置正确：

  <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="cleanassistant.net" />
      <data android:scheme="https" android:host="www.cleanassistant.net" />
  </intent-filter>
  

• 手动触发链接验证
  在设备Chrome浏览器中输入深度链接地址，点击地址栏的"打开应用"提示（若出现）测试；若无提示，清除该网站的缓存和权限后重试。

• 检查设备权限设置
  进入设备「设置」-「应用」-「对应应用」-「打开链接」，确认开启「验证链接」选项，若已开启可关闭后重新开启，触发验证流程。

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