点击通知打开TWA失败：client.focus()无效的技术解决方案咨询

这个问题我之前帮开发者排查过类似的——TWA在后台时Service Worker调用client.focus()被浏览器拦截，本质是TWA的运行上下文和普通PWA有差异，Chrome对后台TWA的窗口操作有额外权限限制。下面给你几个可行的解决方案，按优先级排序：

1. 给Service Worker的focus逻辑添加错误捕获与降级 #

既然client.focus()会报错，我们可以捕获这个错误，降级到clients.openWindow()来唤起后台的TWA（前提是你的TWA和域名已经正确关联）。修改后的代码如下：

self.addEventListener('notificationclick', function(event) {
  event.notification.close();
  event.waitUntil(
    clients
      .matchAll({ type: 'window', includeUncontrolled: true })
      .then(function(clientList) {
        for (let i = 0; i < clientList.length; i++) {
          const client = clientList[i];
          const isChatAppUrl = client.url.includes('.com/messages') || client.url.includes('.co/messages');
          if (isChatAppUrl && 'focus' in client) {
            // 尝试聚焦窗口，失败则降级到打开链接
            return client.focus()
              .catch(err => {
                console.error('聚焦窗口失败:', err);
                if (clients.openWindow) {
                  return clients.openWindow(event.notification.data.link);
                }
              });
          }
        }
        // 没有匹配到窗口，直接打开链接
        if (clients.openWindow) {
          return clients.openWindow(event.notification.data.link);
        }
      })
  );
});

2. 配置TWA的AndroidManifest.xml确保实例复用 #

要让clients.openWindow()能唤起后台的TWA而不是新开Chrome标签，你需要在AndroidManifest.xml里给TWA的Activity设置正确的启动模式和Intent过滤器：

<activity
    android:name="com.google.androidbrowserhelper.trusted.LauncherActivity"
    android:launchMode="singleTask"> <!-- 关键：复用后台实例 -->
    <!-- 桌面启动的Intent过滤器 -->
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
    <!-- 处理域名链接的Intent过滤器 -->
    <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="你的域名.com" />
        <!-- 确保包含通知中使用的所有子域名/路径 -->
    </intent-filter>
</activity>

android:launchMode="singleTask"是核心，它告诉Android系统不要创建新的TWA实例，直接唤起后台已存在的实例。

3. 验证Asset Links关联配置 #

你的域名必须通过assetlinks.json文件和TWA的Android应用绑定，这样Chrome才会把该域名的链接路由到TWA而不是普通标签页。这个文件要放在https://你的域名.com/.well-known/assetlinks.json，内容示例：

[
  {
    "relation": ["delegate_permission/common.handle_all_urls"],
    "target": {
      "namespace": "android_app",
      "package_name": "你的Android应用包名",
      "sha256_cert_fingerprints": ["你的应用签名SHA256指纹"]
    }
  }
]

你可以用Chrome的chrome://digitalassetlinks页面验证这个配置是否生效。

4. （可选）直接在Android端处理通知点击 #

如果上面的方案还是有问题，可以绕过Service Worker，直接在Android代码里创建通知并设置跳转逻辑，这种方式更可靠：

val notificationLink = "你的通知目标链接"
val intent = Intent(Intent.ACTION_VIEW, Uri.parse(notificationLink))
// 指定TWA使用的Chrome包，确保路由到TWA
intent.setPackage("com.android.chrome")
val pendingIntent = PendingIntent.getActivity(
    context,
    notificationId,
    intent,
    PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_IMMUTABLE
)

// 构建通知
val notification = NotificationCompat.Builder(context, "你的通知渠道ID")
    .setContentTitle("通知标题")
    .setContentText("通知内容")
    .setSmallIcon(R.drawable.ic_notification)
    .setContentIntent(pendingIntent)
    .setAutoCancel(true)
    .build()

// 发送通知
NotificationManagerCompat.from(context).notify(notificationId, notification)

这种方式直接通过Android系统唤起TWA，不受Service Worker的权限限制。

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