单Task模式下App Link跳转未触发onNewIntent却创建新Activity问题排查

可能的原因及排查方向 #

1. 系统内存紧张导致原任务栈被销毁 #

虽然设置了singleTask启动模式，但当系统内存不足时，会主动回收后台任务栈（哪怕你做了“不保留活动”的禁用处理，这仅针对开发者选项的强制设置，系统自身的内存回收逻辑不受此限制）。此时App Link跳转时，原Activity实例已不存在，系统只能创建新实例并调用onCreate；而SavedStateHandle的状态仅在Activity被系统销毁后重建时才会恢复，若原任务栈被彻底销毁，没有保留任何状态，SavedStateHandle自然为空。

排查方式：在Activity的onSaveInstanceState、onRestoreInstanceState和onCreate中添加日志，记录实例ID和状态恢复情况，确认是否是系统销毁后重建的场景。

2. App Link Intent被添加了冲突的Flags #

部分场景下，系统或自定义标签页的实现会给App Link跳转的Intent自动添加FLAG_ACTIVITY_NEW_TASK、FLAG_ACTIVITY_CLEAR_TASK这类Flags，哪怕你设置了singleTask，这些Flags也可能干扰系统的实例复用逻辑，导致创建新Activity。

排查方式：在onCreate中打印Intent的Flags（intent.flags），查看是否存在触发新实例创建的Flags。比如FLAG_ACTIVITY_NEW_TASK若和现有任务栈不匹配，就可能创建新栈；FLAG_ACTIVITY_CLEAR_TOP虽然通常配合singleTask使用，但如果Intent的Component匹配有问题，也可能导致异常。

3. 多模块Manifest配置冲突或覆盖 #

多模块架构中，若其他模块也声明了相同的App Link Scheme/Host，或者启动Activity的launchMode被其他模块的Manifest配置覆盖，最终合并后的Manifest可能不符合预期——比如singleTask被改成了standard，导致每次跳转都创建新实例。

排查方式：用Android Studio的「Merged Manifest」功能查看最终生效的Manifest，确认启动Activity的launchMode确实是singleTask，且App Link的<intent-filter>没有重复或冲突配置。

4. 自定义标签页的跳转逻辑存在问题 #

自定义标签页（如Custom Tabs）在跳转回App时，若Intent构造不规范（比如未指定明确的ComponentName，或者错误添加了额外Flags），系统可能无法正确匹配到已存在的singleTask实例，从而创建新Activity。

排查方式：检查自定义标签页跳转回App的代码，确保Intent指定了正确的目标Activity，且没有添加不必要的Flags。比如使用CustomTabsIntent.Builder时，避免手动设置FLAG_ACTIVITY_NEW_TASK这类可能引发冲突的Flags。

解决建议 #

• 统一Intent处理逻辑：不管是onNewIntent还是onCreate，都从Intent中提取App Link数据，同时在onCreate中检查SavedStateHandle的数据，若为空则做兜底处理（比如从Intent重新获取必要参数，或提示用户重新发起流程），避免空指针异常。
• 确保状态可恢复：在onSaveInstanceState中主动保存关键数据到SavedStateHandle，确保Activity被系统销毁重建时能正确恢复状态。
• 强制复用实例：在接收App Link的Intent时，手动移除冲突的Flags（比如intent.flags = intent.flags and ~Intent.FLAG_ACTIVITY_NEW_TASK），或者在Manifest中给启动Activity添加android:alwaysRetainTaskState="true"，减少系统销毁任务栈的概率。
• 定期验证Manifest配置：通过「Merged Manifest」确认启动模式和App Link配置符合预期。

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