Android单体应用拆分导航模块：NavHost识别子导航图问题

核心问题修复 #

你遇到的错误根源是对NavGraphBuilder扩展函数的注解理解有误：

• 模块中的导航扩展函数绝对不能加@Composable注解，因为NavHost的lambda是NavGraphBuilder的作用域，并非Composable上下文。
• 之前报错大概率是因为你在导航函数的顶层直接调用了Composable组件（而非放在composable块的lambda内），只要修正这一点，无需加注解就能正常运行。

正确的模块导航函数写法 #

保持扩展函数原样，确保所有Composable组件调用都放在composable的lambda参数内：

// 模块中的导航扩展函数，无需添加@Composable
fun NavGraphBuilder.firstNavGraph() {
    composable("signup") {
        // 这里的lambda是Composable上下文，可安全调用SignupScreen
        SignupScreen()
    }
    // 其他目的地配置
}

依赖一致性检查 #

确保所有模块引入的Navigation Compose依赖版本一致，避免因版本差异导致的语法错误：

// 各模块build.gradle.kts中添加
implementation("androidx.navigation:navigation-compose:2.7.7")

其他可行方案 #

如果需要更灵活的模块化集成，可尝试以下两种方案：

方案一：XML导航图集成 #

每个模块定义独立的导航图XML资源，主模块通过include函数引入：

@Composable
fun MainNavGraph() {
    val navController = rememberNavController()
    NavHost(navController = navController, startDestination = "start") {
        // 引入模块1的导航图
        navigation(startDestination = "signup", route = "first_graph") {
            include(navGraph = R.navigation.nav_graph_first)
        }
        // 引入模块2的导航图
        navigation(startDestination = "home", route = "second_graph") {
            include(navGraph = R.navigation.nav_graph_second)
        }
    }
}

模块中创建res/navigation/nav_graph_first.xml，自行配置目的地和跳转逻辑。

方案二：接口化导航提供者 #

通过定义接口实现完全解耦的动态集成，适合大型项目：

// 公共模块定义导航提供者接口
interface NavGraphProvider {
    fun NavGraphBuilder.addNavGraph()
}

// 模块1实现接口
class FirstNavGraphProvider : NavGraphProvider {
    override fun NavGraphBuilder.addNavGraph() {
        composable("signup") { SignupScreen() }
    }
}

// 模块2实现接口
class SecondNavGraphProvider : NavGraphProvider {
    override fun NavGraphBuilder.addNavGraph() {
        composable("home") { HomeScreen() }
    }
}

// 主模块通过依赖注入收集所有实现类并集成
@Composable
fun MainNavGraph(
    navGraphProviders: Set<@JvmSuppressWildcards NavGraphProvider>
) {
    val navController = rememberNavController()
    NavHost(navController = navController, startDestination = "start") {
        navGraphProviders.forEach { it.addNavGraph() }
    }
}

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