为何Android开发中FragmentStateAdapter调用onActivityResult出现失效问题

在使用ViewPager2+FragmentStateAdapter实现多标签页的Android应用中，常出现子Fragment跳转新Activity后onActivityResult失效的问题。典型业务场景如下：

Activity1内包含两个标签页：员工列表（workers_list）、备忘（notes）。点击员工列表任意条目跳转员工详情页，修改信息返回后列表未按预期刷新。
预期效果如下：

• 调用入口错误：子Fragment跳转新Activity时误用requireActivity().startActivityForResult()，结果仅会回调到宿主Activity，不会分发到对应Fragment。
• 宿主Activity未正确分发回调：宿主Activity重写onActivityResult时未调用super.onActivityResult()，系统无法将结果传递给子Fragment。
• Fragment被意外销毁：FragmentStateAdapter默认会销毁超出离屏缓存范围的Fragment，详情页返回时原列表Fragment已重建，原有实例的回调无法触发。
• 旧API兼容性问题：AndroidX Fragment 1.2.0之后onActivityResult已被标记为废弃，高版本库对旧回调的分发逻辑存在兼容缺陷。

方案1：修正旧API的调用逻辑（适用于尚未迁移Result API的存量项目） #

1. 子Fragment跳转时调用自身的startActivityForResult，不要通过Activity调用

// 错误写法
// requireActivity().startActivityForResult(intent, 1001)
// 正确写法
startActivityForResult(intent, 1001)

2. 宿主Activity的onActivityResult必须先调用super方法

@Override
protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
    // 必须先执行super逻辑，完成子Fragment的结果分发
    super.onActivityResult(requestCode, resultCode, data);
    // 下方编写Activity自身的结果处理逻辑
}

3. 调整ViewPager2的离屏缓存，避免Fragment被销毁：

// 离屏缓存数和标签总数保持一致，本例共2个标签
viewPager2.offscreenPageLimit = 2

方案2：使用官方推荐的Activity Result API（推荐，无分发问题） #

该API是onActivityResult的官方替代方案，结果直接回调到注册的Fragment/Activity，不受Fragment重建影响，无需宿主额外处理。

1. 在员工列表Fragment中注册结果回调

private val updateWorkerLauncher = registerForActivityResult(ActivityResultContracts.StartActivityForResult()) { result ->
    if (result.resultCode == Activity.RESULT_OK) {
        // 拿到详情页返回的数据，刷新列表
        val updateFlag = result.data?.getBooleanExtra("is_update", false) ?: false
        if (updateFlag) workerListAdapter.refresh()
    }
}

2. 跳转详情页时使用注册的launcher启动

val intent = Intent(requireContext(), WorkerDetailActivity::class.java).apply {
    putExtra("worker_id", clickedWorkerId)
}
updateWorkerLauncher.launch(intent)

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