Android中Hamburger按钮无法触发NavigationUI导航抽屉问题

核心排查与修复点 #

1. 确认NavigationUI.setupActionBarWithNavController()的完整绑定 #

必须同时传入DrawerLayout实例，否则汉堡按钮只会处理返回逻辑，不会关联抽屉开关。正确调用示例：

// 在CategoryActivity的onCreate方法中
val navController = findNavController(R.id.nav_host_fragment)
val drawerLayout = findViewById<DrawerLayout>(R.id.drawer_layout)
NavigationUI.setupActionBarWithNavController(this, navController, drawerLayout)
NavigationUI.setupWithNavController(findViewById(R.id.nav_view), navController)

2. 修正onSupportNavigateUp()的实现 #

重写该方法时，必须传入DrawerLayout给NavigationUI.navigateUp()，不能直接返回父类方法。正确写法：

override fun onSupportNavigateUp(): Boolean {
    val navController = findNavController(R.id.nav_host_fragment)
    val drawerLayout = findViewById<DrawerLayout>(R.id.drawer_layout)
    return NavigationUI.navigateUp(navController, drawerLayout) || super.onSupportNavigateUp()
}

3. 验证布局结构正确性 #

确保DrawerLayout是根布局，内部包含主内容区（含NavHostFragment）和NavigationView，示例结构：

<androidx.drawerlayout.widget.DrawerLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:id="@+id/drawer_layout"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:fitsSystemWindows="true">

    <!-- 主内容区域 -->
    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:orientation="vertical">

        <com.google.android.material.appbar.AppBarLayout
            android:layout_width="match_parent"
            android:layout_height="wrap_content">

            <androidx.appcompat.widget.Toolbar
                android:id="@+id/toolbar"
                android:layout_width="match_parent"
                android:layout_height="?attr/actionBarSize"
                android:background="?attr/colorPrimary"/>
        </com.google.android.material.appbar.AppBarLayout>

        <fragment
            android:id="@+id/nav_host_fragment"
            android:name="androidx.navigation.fragment.NavHostFragment"
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            app:defaultNavHost="true"
            app:navGraph="@navigation/nav_graph_category"/>
    </LinearLayout>

    <!-- 导航抽屉 -->
    <com.google.android.material.navigation.NavigationView
        android:id="@+id/nav_view"
        android:layout_width="wrap_content"
        android:layout_height="match_parent"
        android:layout_gravity="start"
        app:menu="@menu/drawer_menu_category"/>
</androidx.drawerlayout.widget.DrawerLayout>

注意DrawerLayout需设置android:fitsSystemWindows="true"，避免触摸区域异常。

4. 检查依赖版本一致性 #

确保Navigation组件与Material组件版本匹配，避免API行为冲突，示例依赖：

dependencies {
    implementation "androidx.navigation:navigation-fragment-ktx:2.7.6"
    implementation "androidx.navigation:navigation-ui-ktx:2.7.6"
    implementation "com.google.android.material:material:1.11.0"
}

快速验证流程 #

1. 确认setupActionBarWithNavController传入了DrawerLayout；
2. 替换onSupportNavigateUp()为上述正确代码；
3. 重启应用测试汉堡按钮功能。

若仍未解决，检查是否有自定义Toolbar的setNavigationOnClickListener逻辑，该代码会覆盖NavigationUI的默认绑定行为。

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