Android standard启动模式下Deeplink失效 singleTask破坏返回栈问题如何解决

singleTask 启动模式的Activity作为应用任务栈的根节点时，每次从桌面点击图标启动应用，系统会默认触发栈清理逻辑，清空该Activity上方的所有其他Activity实例，这是Android官方设计的标准行为。如果将其改为standard启动模式，每次deeplink唤起都会创建新的主Activity实例，无法复用原有实例执行统一的deeplink分发逻辑，自然会出现deeplink异常。

方案1：保留singleTask配置，新增启动场景判断（侵入性最低，优先推荐） #

不需要修改原有deeplink处理逻辑，仅在主Activity补充少量判断代码即可：

• 保留主Activity A的singleTask启动模式不变，保证deeplink唤起时始终复用栈内已有实例处理分发
• 在A的onCreate方法开头新增异常启动场景判断：

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    // 检测当前Activity是否是被系统主动拉到前台，而非用户主动触发
    if ((intent.flags and Intent.FLAG_ACTIVITY_BROUGHT_TO_FRONT) != 0) {
        finish()
        return
    }
    // 原有初始化逻辑
    handleIntent(intent)
}

override fun onNewIntent(intent: Intent?) {
    super.onNewIntent(intent)
    // 更新Intent引用，避免拿到旧数据
    setIntent(intent)
    handleIntent(intent)
}

private fun handleIntent(intent: Intent?) {
    intent ?: return
    // 此处执行原有的deeplink处理逻辑即可
}

该方案的逻辑是：当应用已经在后台运行、任务栈上层存在Activity B时，点击桌面图标触发的启动会命中FLAG_ACTIVITY_BROUGHT_TO_FRONT标记，此时直接结束当前触发的主Activity启动流程，系统会自动展示原有任务栈的栈顶Activity（即B），不会破坏原有栈结构，也不影响deeplink的正常处理。

方案2：新增独立deeplink中转Activity（完全解耦，无副作用） #

如果不想修改主Activity的原有逻辑，可以用中转页实现解耦：

• 将主Activity A改回standard启动模式，保证返回栈逻辑完全符合预期
• 新增一个无UI的透明Activity作为deeplink专属中转页，设置其启动模式为singleTask
• 将AndroidManifest中原本配置在A上的所有deeplink相关<intent-filter>全部迁移到中转Activity上
• 在中转Activity中完成deeplink解析、跳转逻辑后直接调用finish()销毁自身，不会占用任务栈节点

该方案完全隔离了主页面启动逻辑和deeplink处理逻辑，两个需求互不干扰，后续扩展deeplink规则也不会影响主页面的稳定性。

方案3：自定义taskAffinity实现多栈隔离（非必要不推荐） #

• 为主Activity A单独配置自定义的taskAffinity属性，和应用默认的任务栈标识区分开，让A运行在独立的任务栈中
• 此时A的singleTask逻辑只会作用于自身的独立栈，不会影响主应用任务栈的返回栈结构
  注意：该方案需要自行处理多任务栈的管理逻辑，容易出现桌面多任务卡片、页面跳转错乱等体验问题，仅适合deeplink需要独立开栈的特殊场景使用。

• 处理deeplink逻辑时建议统一增加去重判断，避免同一个deeplink被多次触发导致重复创建页面
• 重写onNewIntent时记得调用setIntent()更新Intent引用，避免后续逻辑拿到旧的Intent数据产生错误

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