Trusted Web Activity PostMessage示例代码无法运行求助排查

以下是导致onRelationshipValidationResult返回false的常见原因及对应的修复方案：

1. 数字资产链接（Digital Asset Links）配置错误 #

• 路径问题：assetlinks.json必须放置在网站根目录的.well-known文件夹下，访问路径应为https://你的域名/.well-known/assetlinks.json，确保该文件能正常被访问（可通过curl命令验证）。
• 内容不匹配：文件中的package_name必须与TWA应用的完整包名完全一致，sha256_cert_fingerprints必须匹配应用签名密钥的SHA256指纹。
  • 获取SHA256指纹命令：keytool -list -v -keystore 你的密钥库文件.jks（调试环境默认密钥库路径为~/.android/debug.keystore，密码为android）。
  • 确保JSON格式无语法错误，示例结构：

    [{
      "relation": ["delegate_permission/common.handle_all_urls"],
      "target": {
        "namespace": "android_app",
        "package_name": "com.example.twa",
        "sha256_cert_fingerprints": ["你的SHA256指纹"]
      }
    }]
    

2. AndroidManifest配置错误 #

• 域名匹配问题：TWA启动Activity的android.support.customtabs.trusted.DEFAULT_URL元数据必须指向配置了assetlinks.json的域名，且intent-filter中data的android:host需与该域名完全一致（不带http/https前缀）。
• 冗余配置冲突：若已通过assetlinks.json配置验证，需移除Activity中android.support.customtabs.trusted.SHA256_CERT_FINGERPRINTS元数据，避免本地配置与远程验证冲突。
• 正确的Activity配置示例：

  <activity
      android:name="com.google.androidbrowserhelper.trusted.LauncherActivity"
      android:label="@string/app_name">
      <meta-data
          android:name="android.support.customtabs.trusted.DEFAULT_URL"
          android:value="https://你的域名" />
      <intent-filter>
          <action android:name="android.intent.action.MAIN" />
          <category android:name="android.intent.category.LAUNCHER" />
      </intent-filter>
      <intent-filter>
          <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="你的域名" />
      </intent-filter>
  </activity>
  

3. 调试/发布环境指纹不匹配 #

调试时使用的是Android Studio默认调试密钥库，其SHA256指纹与发布版密钥库不同。若assetlinks.json仅配置了发布版指纹，调试阶段会验证失败。

• 修复：将调试版密钥库的SHA256指纹添加到assetlinks.json的sha256_cert_fingerprints数组中，同时保留发布版指纹。

4. 网站HTTPS配置异常 #

TWA要求网站必须使用有效HTTPS证书：

• 自签名证书在正式环境不被认可，调试阶段可使用ngrok等工具将本地服务暴露为HTTPS，或使用可信测试证书。
• 确保网站无域名跳转（如访问https://你的域名不会跳转到其他域名），否则验证会失败。

5. Web端PostMessage初始化时机错误 #

Web端代码需在页面加载完成后初始化PostMessage，并确保origin参数与TWA配置的域名一致：

window.addEventListener('load', () => {
    if (window.chrome?.webview) {
        window.chrome.webview.postMessage('init', 'https://你的域名');
    }
});

window.chrome?.webview.addEventListener('message', (event) => {
    console.log('收到TWA消息:', event.data);
});

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