多模块Android项目导航库版本冲突及类型安全导航失效咨询

我正在开发一个多模块Android项目，希望使用最新的Navigation Library以利用**类型安全导航（Type Safe Navigation）**特性。

按照常规操作，我在libs.toml文件中添加了库引用并将其引入主模块：

# libs.toml 中的配置
navigationVersion = "2.8.9"
androidx-navigation-compose = { group = "androidx.navigation", name = "navigation-compose", version.ref = "navigationVersion" }

# 主模块的 build.gradle.kts 依赖配置
dependencies {
    implementation(libs.com.jakewharton.timber)
    implementation(libs.androidx.security.cryto.ktx)
    implementation(libs.bundles.compose)
    implementation(libs.androidx.activity.kotlin)
    implementation(libs.androidx.core.splashscreen)
    implementation(libs.androidx.core.ktx)
    implementation(libs.org.jetbrains.kotlinx.collections.immutable)
    implementation(libs.com.google.android.gms.maps)
    implementation(libs.androidx.navigation-compose) // 引入导航库
    // ... 其他依赖
}

但尝试使用类型安全导航方法时，始终提示该方法不存在：

@Serializable
data object Name

navHostController.navigate(Name)

错误信息如下：

None of the following functions can be called with the arguments supplied.
navigate(Uri) defined in androidx.navigation.NavHostController
navigate(NavDeepLinkRequest) defined in androidx.navigation.NavHostController
navigate(NavDirections) defined in androidx.navigation.NavHostController
navigate(Int) defined in androidx.navigation.NavHostController
navigate(String, NavOptions? = ..., Navigator.Extras? = ...) defined in androidx.navigation.NavHostController

随后我发现项目中除了2.8.9版本外，还存在2.5.1版本的导航库，且引入NavHostController时默认使用2.5.1版本，但libs.toml中并未配置该版本。同时项目中有大量库存在多版本共存的情况。

请问这种情况的原因是什么？如何检测并移除这些未配置的旧版本依赖？

• 间接依赖引入旧版本：Android Gradle会自动拉取依赖库的间接依赖，你的项目中某个模块或第三方库可能依赖了旧版本的Navigation库（2.5.1），导致Gradle同时下载多个版本。
• 依赖解析优先级问题：默认Gradle会选最新版本，但如果某个模块强制指定旧版本，或者依赖解析顺序导致旧版本被优先选中，就会出现旧版本被实际使用的情况。

1. 检测所有依赖版本 #

在项目根目录终端执行以下命令，生成完整依赖树，定位Navigation相关依赖的来源：

./gradlew app:dependencies --configuration implementation

（将app替换为你的主模块名称）

也可以用过滤命令直接查看Navigation相关依赖：

./gradlew app:dependencies --configuration implementation | grep -A 5 -B 5 "navigation"

2. 强制统一依赖版本 #

在项目根目录的build.gradle.kts（或build.gradle）中添加版本强制规则，确保所有Navigation组件都使用2.8.9版本：

// 根目录 build.gradle.kts
allprojects {
    configurations.all {
        resolutionStrategy {
            force("androidx.navigation:navigation-compose:2.8.9")
            force("androidx.navigation:navigation-runtime-ktx:2.8.9")
            force("androidx.navigation:navigation-common-ktx:2.8.9")
            // 按需添加其他Navigation组件，比如navigation-fragment等
        }
    }
}

3. 排查并移除冗余依赖 #

• 检查所有模块的build.gradle.kts文件，若有直接引入旧版本Navigation库的代码，删除或替换为libs.toml中的统一引用。
• 对于第三方库带来的间接旧版本依赖，可通过exclude排除：

// 示例：排除某第三方库中的旧版本Navigation依赖
implementation("com.example:some-library:1.0.0") {
    exclude(group = "androidx.navigation", module = "navigation-runtime")
}

4. 验证依赖状态 #

再次执行依赖树命令，确认所有Navigation相关库均为2.8.9版本，同步项目后重新编译，测试类型安全导航功能是否正常。

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