Android Fragment导航返回箭头与系统返回键行为不一致如何解决

开发基于Fragment的Android应用时，存在两类向上/返回导航操作：

• 点击导航栏上的返回箭头
• 点击设备系统返回按钮

在Fragment的onCreateView生命周期中编写如下返回逻辑后，测试发现逻辑仅对系统返回按钮生效，无法拦截导航栏返回箭头的点击：

override fun onCreateView(
        inflater: LayoutInflater, container: ViewGroup?,
        savedInstanceState: Bundle?
    ): View {
// 其他初始化逻辑省略
        requireActivity().onBackPressedDispatcher.addCallback(this) {
                findNavController().navigate(R.id.action_updateFragment_to_listFragment)
        }
// 其他逻辑省略
}

onBackPressedDispatcher 只会拦截系统实体/虚拟返回键的触发事件，导航栏的返回箭头属于ActionBar/Toolbar的独立菜单点击事件，默认不会走系统返回的分发链路，所以写在回调里的逻辑不会被触发。

根据项目用的导航栏类型选对应实现即可：

方案1：使用Navigation组件默认关联（推荐，逻辑统一） #

如果项目接入了Android Jetpack Navigation组件，只需要做两步配置，就能让导航栏返回箭头和系统返回键走同一套返回逻辑，不需要重复编写代码：

1. 在宿主Activity中重写onSupportNavigateUp方法，把向上导航事件委托给NavController处理：

class MainActivity : AppCompatActivity() {
    override fun onSupportNavigateUp(): Boolean {
        val navController = findNavController(R.id.nav_host_fragment_container)
        return navController.navigateUp() || super.onSupportNavigateUp()
    }
}

2. 在对应Fragment的onViewCreated生命周期中，把ActionBar和NavController做关联：

override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    super.onViewCreated(view, savedInstanceState)
    NavigationUI.setupActionBarWithNavController(
        requireActivity() as AppCompatActivity,
        findNavController()
    )
}

配置完成后，之前写在onBackPressedDispatcher里的自定义返回逻辑，导航栏返回箭头触发时也会正常执行。

方案2：手动拦截导航栏返回点击（适合完全自定义逻辑的场景） #

如果不需要走Navigation组件默认的返回栈逻辑，要完全自定义点击行为，可以直接拦截ActionBar的Home按钮点击事件：

1. 先在Fragment中声明要接收选项菜单事件，把返回逻辑抽成公共方法避免重复编写：

override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    super.onViewCreated(view, savedInstanceState)
    setHasOptionsMenu(true)
    // 注意：回调绑定到viewLifecycleOwner，不要直接传this，避免内存泄漏
    requireActivity().onBackPressedDispatcher.addCallback(viewLifecycleOwner) {
        handleCustomBack()
    }
}

private fun handleCustomBack() {
    // 这里写统一的返回逻辑，不管是点系统返回还是导航栏返回都走这里
    findNavController().navigate(R.id.action_updateFragment_to_listFragment)
}

2. 重写菜单选择方法，拦截返回箭头的点击事件：

override fun onOptionsItemSelected(item: MenuItem): Boolean {
    return when (item.itemId) {
        android.R.id.home -> {
            // android.R.id.home 对应的就是导航栏左侧的返回箭头按钮
            handleCustomBack()
            true
        }
        else -> super.onOptionsItemSelected(item)
    }
}

注意：不要在onCreateView里注册返回回调，onCreateView仅负责加载视图，相关视图生命周期的逻辑建议放到onViewCreated中处理，同时onBackPressedDispatcher的回调要绑定viewLifecycleOwner，避免Fragment视图销毁后回调仍然存在导致内存泄漏、崩溃问题。

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