Telegram Mini App：点击链接时如何聚焦已打开实例而非新建？

目前Telegram官方没有提供直接唤起已打开Mini App实例的原生API，但可以通过以下几种方案间接实现需求：

方案1：会话检测+新实例自动关闭 #

• 后端维护用户Telegram ID与当前活跃应用会话的绑定关系（比如用Redis存储在线状态）
• 用户通过直接链接打开新实例时，前端先向后端查询当前用户是否已有活跃的Mini App会话
• 如果存在活跃会话，前端直接调用Telegram.WebApp.close()关闭当前新实例，同时显示提示文本（比如“您的应用已在后台运行，返回聊天界面即可继续使用”）
• 用户关闭新实例后回到聊天界面，之前的Mini App实例仍在后台，可通过聊天顶部的应用入口返回

方案2：同上下文实例的本地存储通信 #

如果用户是在同一个Telegram客户端的同一WebView环境下打开重复链接（比如从同一聊天窗口多次点击），可以利用localStorage实现跨实例通信：

• 已有实例加载时，写入活跃标记并监听存储变化：

  // 标记当前实例为活跃
  localStorage.setItem('mini_app_active', 'true');
  
  // 监听存储事件，收到聚焦指令时展开应用
  window.addEventListener('storage', (e) => {
    if (e.key === 'focus_mini_app' && e.newValue === 'trigger') {
      Telegram.WebApp.expand();
      localStorage.removeItem('focus_mini_app');
    }
  });
  
  // 页面卸载时清除活跃标记
  window.addEventListener('beforeunload', () => {
    localStorage.removeItem('mini_app_active');
  });
  

• 新实例加载时，检查活跃标记：

  if (localStorage.getItem('mini_app_active')) {
    // 发送聚焦指令给已有实例
    localStorage.setItem('focus_mini_app', 'trigger');
    // 延迟关闭当前实例，确保指令被接收
    setTimeout(() => {
      Telegram.WebApp.close();
    }, 600);
  } else {
    localStorage.setItem('mini_app_active', 'true');
  }
  

• 注意：该方案仅在同WebView上下文生效，不同聊天窗口打开的实例无法共享localStorage，此时需结合方案1处理。

方案3：自定义链接跳转逻辑 #

生成直接链接时，附加用户唯一标识（比如Telegram用户ID的哈希值），前端加载时先检查当前页面的链接参数与本地存储的用户标识是否匹配：

• 首次打开时，存储链接中的用户标识到sessionStorage
• 后续打开新实例时，对比标识：如果匹配，说明是同一用户重复打开，直接关闭新实例；如果不匹配，再执行正常初始化逻辑

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