Android App Links验证失败（错误码1024）求助

问题背景 #

我有一个applicationId为com.unibeam.passkey1的Android应用，已在https://unibeam.github.io/.well-known/assetlinks.json存储对应配置文件（包含调试和发布版本的SHA256证书指纹），通过Google资产链接API查询无报错。应用manifest.xml中配置了带android:autoVerify="true"的intent-filter，但执行adb shell pm get-app-links --user cur com.unibeam.passkey1命令时，显示unibeam.github.io的域名验证状态为1024，该域名被禁用。请问失败原因是什么？是否需要将应用上架Play Store才能正常工作？

失败原因分析 #

状态码1024对应DOMAIN_DISABLED，常见触发原因包括：

• 应用或域名存在违规记录：若你的应用（或同一开发者账号下其他应用）违反过Google Play政策，或该域名曾被用于违规应用的链接验证，可能会被Google标记禁用。
• assetlinks.json隐性配置错误：尽管API查询无报错，但可能存在细节问题：比如SHA256指纹大小写不匹配、applicationId拼写错误、JSON结构层级错误，或者文件的Content-Type未设置为application/json。
• 调试环境签名不匹配：调试版本应用使用本地签名证书，若assetlinks.json中优先配置了Play发布签名的指纹，系统校验时会因签名不匹配触发禁用标记。
• 域名HTTPS或DNS异常：域名的HTTPS证书过期、不被Android系统信任，或DNS解析异常，也可能导致验证失败并标记域名禁用。

是否需要上架Play Store？ #

分场景判断：

• 调试阶段：无需上架，但需满足以下条件：
  • 调试签名指纹已正确写入assetlinks.json
  • 测试设备可临时执行adb shell settings put global package_verifier_enable 0关闭系统验证（仅用于调试，生产环境禁用）
  • 确认manifest.xml中intent-filter配置正确：包含android.intent.action.VIEW action，android.intent.category.DEFAULT和android.intent.category.BROWSABLE category，data标签正确匹配域名
• 生产环境：必须上架Google Play并启用Play App Signing。因为Google会用Play签名的证书指纹校验assetlinks.json，而非你本地的发布指纹；未上架的自行分发APK，几乎无法在普通用户设备上通过App Links验证。

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