Android Kotlin应用Fragment返回键导航失效，伴窗口焦点警告求助

我用Kotlin开发Android应用时，遇到Fragment间无法通过返回键导航返回的问题，同时收到如下警告：

Cancelling event due to no window focus: KeyEvent { action=ACTION_UP, keyCode=KEYCODE_BACK, scanCode=0, metaState=0, flags=0x68, repeatCount=0, eventTime=224793910, downTime=224793513, deviceId=-1, source=0x101, displayId=0 }

导航图XML内容如下：

<?xml version="1.0" encoding="utf-8"?>
<navigation xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/nav_graph"
    app:startDestination="@id/splash_fragment">

    <fragment
        android:id="@+id/splash_fragment"
        android:name="com.xxx.yyy.splash.fragment.SplashFragment"
        android:label="SplashFragment"
        tools:layout="@layout/fragment_splash">
        <action android:id="@+id/action_splash_to_account_management"
            app:destination="@id/account_management_fragment"/>
        <action
            android:id="@+id/action_splash_fragment_to_identity_fragment_with_camera"
            app:destination="@id/identity_fragment_with_camera" />
    </fragment>

    <fragment
        android:id="@+id/privacy_policy_fragment"
        android:name="com.xxx.yyy.presentation.privacy_policy.fragment.PrivacyPolicyFragment"
        android:label="PrivacyPolicyFragment"
        tools:layout="@layout/fragment_privacy_policy">

        <action android:id="@+id/action_privacy_policy_to_verif_number"
            app:destination="@id/verif_number_fragment"/>
    </fragment>

    <fragment
        android:id="@+id/verif_number_fragment"
        android:name="com.xxx.yyy.presentation.register.fragment.VerifNumberFragment"
        android:label="VerifNumberFragment"
        tools:layout="@layout/fragment_verif_number">
        <action android:id="@+id/action_verif_number_to_verif_otp"
            app:destination="@id/verif_otp_fragment"/>

    </fragment>

    <fragment
        android:id="@+id/identity_fragment_with_camera"
        android:name="com.xxx.yyy.Cameraphoto"
        android:label="fragment_identity_with_camera"
        tools:layout="@layout/fragment_identity_with_camera" >
        <action
            android:id="@+id/action_identity_fragment_with_camera_to_selfieCamera"
            app:destination="@id/selfieCamera" />
        <argument
            android:name="imageUri"
            app:argType="string"
            android:defaultValue="@null"
            app:nullable="true"/>
        <action
            android:id="@+id/action_identity_fragment_with_camera_to_videoRecorder"
            app:destination="@id/videoRecorder" />
    </fragment>
    <fragment
        android:id="@+id/selfieCamera"
        android:name="com.xxx.yyy.SelfieCamera"
        android:label="fragment_selfie_camera"
        tools:layout="@layout/fragment_selfie_camera" >
        <action
            android:id="@+id/action_selfieCamera_to_identity_fragment_with_camera"
            app:destination="@id/identity_fragment_with_camera" />
    </fragment>
    <fragment
        android:id="@+id/videoRecorder"
        android:name="com.xxx.yyy.VideoRecorder"
        android:label="fragment_video_recorder"
        tools:layout="@layout/fragment_video_recorder" >
        <action
            android:id="@+id/action_videoRecorder_to_identity_fragment_with_camera"
            app:destination="@id/identity_fragment_with_camera" />
    </fragment>
</navigation>

Fragment导航代码：

mainNavController().navigate(SplashFragmentDirections.actionSplashFragmentToIdentityFragmentWithCamera(data))

1. 修复窗口焦点丢失问题 #

警告核心是no window focus，说明返回键触发时页面未获取焦点，重点排查相机相关Fragment：

• 在Cameraphoto、SelfieCamera、VideoRecorder的onPause/onStop方法中，强制释放相机资源、停止预览，确保焦点回归宿主Activity。
• 检查页面是否存在未关闭的Dialog/PopupWindow，这类组件会抢占焦点，需在返回前关闭。

2. 验证导航栈状态 #

返回键失效可能是导航栈未正确记录历史，打印栈内容确认：

// 跳转前后打印栈信息
Log.d("NavStack", "Before navigate: ${mainNavController().backStack.map { it.destination.displayName }}")
mainNavController().navigate(SplashFragmentDirections.actionSplashFragmentToIdentityFragmentWithCamera(data))
Log.d("NavStack", "After navigate: ${mainNavController().backStack.map { it.destination.displayName }}")

如果栈中没有SplashFragment，说明跳转时误清空了栈，检查是否在代码或导航图中设置了popUpTo/popUpToInclusive属性。

3. 检查导航Action配置 #

确认action_splash_fragment_to_identity_fragment_with_camera未设置popUpTo相关属性，同时排查代码中是否通过NavOptions手动清空栈：

// 错误示例：该配置会清除SplashFragment，导致无法返回
val navOptions = NavOptions.Builder()
    .setPopUpTo(R.id.splash_fragment, inclusive = true)
    .build()

若存在此类代码，移除即可恢复返回栈。

4. 确认导航组件绑定正确性 #

确保宿主Activity中导航控制器是从正确的NavHostFragment获取：

// 正确获取方式
val navHostFragment = supportFragmentManager.findFragmentById(R.id.nav_host_fragment) as NavHostFragment
val navController = navHostFragment.navController

如果mainNavController()是自定义方法，需确认它指向的是当前页面的NavHostFragment控制器，避免使用错误的导航栈。

5. 排查返回键拦截逻辑 #

检查是否有Fragment/Activity重写onBackPressed()或使用OnBackPressedCallback拦截返回事件：

• 若重写onBackPressed()，需确保优先让导航组件处理返回：

override fun onBackPressed() {
    if (navController.popBackStack()) {
        return
    }
    super.onBackPressed()
}

• 若使用OnBackPressedCallback，需在回调中正确处理返回逻辑，或在不需要拦截时移除回调。

6. 优化相机Fragment返回处理 #

相机Fragment涉及硬件资源，可手动绑定返回键回调，确保返回时释放资源并正确导航：

// 在SelfieCamera/VideoRecorder中添加
override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    requireActivity().onBackPressedDispatcher.addCallback(this) {
        releaseCamera() // 自定义释放相机资源的方法
        navController.popBackStack()
    }
}

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