You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Android App Links是否支持使用自定义端口?

App Links自定义端口不生效的排查与解决

针对你遇到的App Links自定义端口无法生效的问题,结合配置和验证情况,可从以下几个方向排查解决:

  • 确认Asset Links文件的部署路径
    务必保证assetlinks.json文件部署在带自定义端口的域名根路径下,也就是对应https://my-domain.com:203/.well-known/assetlinks.json的位置。App Links验证过程会严格匹配端口对应的域名路径,即使Google工具显示验证通过,也要确认服务器在该端口下能正常返回这个文件(可以直接用浏览器访问该地址测试)。

  • 检查intent-filter配置的准确性

    • 确认android:port属性值与服务器监听的HTTPS端口完全一致,无拼写错误;同时确保该端口的HTTPS服务配置了合法的SSL证书(自签证书仅适用于已手动信任的测试设备)。
    • 尝试拆分<data>标签的配置,可能解决系统解析优先级问题:
      <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="my-domain.com"/>
        <data android:port="203"/>
      </intent-filter>
      
  • 查看系统端的验证状态
    使用adb命令直接检查系统对App Links的验证结果:

    adb shell dumpsys package domain-preferred-apps
    

    搜索你的应用包名和域名,查看是否显示verified=true,以及端口是否正确关联。如果显示verified=false,说明系统验证未通过,可能是端口的HTTPS服务存在跳转、CORS限制或文件权限问题。

  • 测试完整带端口的链接
    测试时必须使用完整的带端口链接(如https://my-domain.com:203/test),避免浏览器或其他应用自动修改端口。也可以用adb命令直接触发验证:

    adb shell am start -a android.intent.action.VIEW -d "https://my-domain.com:203/test"
    

    观察是否能直接唤起你的应用。

  • 确认Android版本兼容性
    App Links功能从Android 6.0(API 23)开始支持,自定义端口的处理在高版本系统中兼容性较好,但低版本设备可能存在限制,建议在目标版本设备上做针对性测试。

内容的提问来源于stack exchange,提问作者Athorcis

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.30 09:08:37