Android端PWA WebApp上传assetslink.json后地址栏无法隐藏

核心问题定位 #

你访问assetlinks.json时出现Uncaught TypeError: Cannot read properties of null (reading 'setAttribute')报错，已经直接指向验证失败的根因：当前访问该路径返回的不是JSON静态文件，而是你的站点前端页面，站点全局JS在执行时找不到目标DOM节点才抛出这个错误。Android系统的可信网络活动（TWA）域名验证拿不到正确的校验文件，就会把应用当成普通网页打开，常驻显示地址栏。

分步修复方案 #

1. 修复assetlinks.json的访问配置 #

• 确认文件存放路径完全符合规范：必须放在站点根目录的.well-known文件夹下，完整可访问路径为https://你的域名/.well-known/assetlinks.json，禁止修改路径、禁止给路径加访问鉴权。
• 修正服务器路由规则：给/.well-known/*路径配置静态文件直出规则，禁止将该路径的请求重写到单页应用入口（如index.html），保证访问该路径时HTTP响应头Content-Type为application/json，返回内容是纯JSON文本，不加载任何站点前端JS。
• 校验文件内容正确性，参考标准格式：

[
  {
    "relation": ["delegate_permission/common.handle_all_urls"],
    "target": {
      "namespace": "android_app",
      "package_name": "与APK打包配置完全一致的应用包名",
      "sha256_cert_fingerprints": [
        "APK签名密钥的SHA256指纹：注意debug测试包、release正式包的签名指纹不同，测试时必须填入对应签名的指纹值"
      ]
    }
  }
]

• 配置完成后可通过adb命令验证域名校验状态：连接设备执行adb shell dumpsys package d，在返回结果中找到你的应用包名，若对应域名的状态为verified才代表校验通过，状态为ask/undefined均为校验失败。

2. 核对manifest.json配置项 #

• 确认display字段值为standalone（独立应用模式）或fullscreen（全屏模式），禁止设置为browser（浏览器模式）。
• 确认start_url与你绑定的域名完全匹配，必须为HTTPS协议，不能出现跨域、HTTP跳转的情况。
• 确认scope字段覆盖应用所有路由路径，常规配置直接设为/即可；若scope配置范围过窄，跳转至范围外的页面时会自动弹出地址栏。

3. 其他常见踩坑处理 #

• 检查Service Worker规则，禁止拦截/.well-known/assetlinks.json请求，不要将该路径的响应缓存为HTML或其他非JSON内容。
• 修改配置后清除Android设备上Chrome的应用缓存，或直接重启设备，系统域名校验存在本地缓存，修改配置后不会立即生效。
• 若使用第三方工具打包APK（如PWABuilder），确认打包配置中填写的启动页地址、包名、签名指纹与assetlinks、manifest中的配置完全一致。

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