Android项目集成Jetpack Navigation后启动报Gradle编译错误

编译报错由两个核心问题触发：

• 冗余依赖冲突：你的项目是Jetpack Compose单栈项目，没有引入Fragment相关基础依赖，却把传统View/Fragment体系下的Navigation全套依赖（navigation-fragment、navigation-ui、动态特性模块支持包）全加进来了，这些依赖编译时找不到Fragment类依赖，直接触发编译中断。
• 依赖版本严重不匹配：你使用的Navigation 2.5.0对Compose、Activity、Lifecycle组件的最低版本有强制要求，当前配置的activity-compose:1.3.1、lifecycle-runtime-ktx:2.3.1是适配Compose 1.0版本的旧组件，和Navigation 2.5.0存在字节码不兼容、方法签名缺失问题，最终Gradle只抛出通用编译错误提示，不会直接打印具体版本冲突栈。

1. 清理冗余Navigation依赖
   纯Compose项目不需要传统View体系的Navigation组件，打开模块级build.gradle，把navigation依赖块里以下内容全部删除：

// Java language implementation
implementation("androidx.navigation:navigation-fragment:$nav_version")
implementation("androidx.navigation:navigation-ui:$nav_version")

// Kotlin
implementation("androidx.navigation:navigation-fragment-ktx:$nav_version")
implementation("androidx.navigation:navigation-ui-ktx:$nav_version")

// Feature module Support
implementation("androidx.navigation:navigation-dynamic-features-fragment:$nav_version")

只保留Compose导航相关的两个依赖即可：

def nav_version = "2.5.0"
// Jetpack Compose Integration
implementation("androidx.navigation:navigation-compose:$nav_version")
// Testing Navigation
androidTestImplementation("androidx.navigation:navigation-testing:$nav_version")

2. 对齐基础依赖版本
   将dependencies块中以下低版本依赖替换为和Navigation 2.5.0兼容的版本：

implementation 'androidx.core:core-ktx:1.8.0'
implementation 'androidx.lifecycle:lifecycle-runtime-ktx:2.5.1'
implementation 'androidx.activity:activity-compose:1.5.1'

同时确认项目级build.gradle中声明的compose_version取值为1.2.1，该版本和Navigation 2.5.0、Kotlin 1.7.10完全适配，不会触发Compose编译器版本校验错误。
3. 同步配置
执行./gradlew clean命令清除旧构建缓存，再点击Gradle Sync同步配置，重新编译即可正常启动应用。

补充说明：如果你的项目是Fragment+Compose混合开发栈，不需要删除Fragment相关Navigation依赖，但必须额外补充implementation 'androidx.fragment:fragment-ktx:1.5.1'依赖，否则navigation-fragment因找不到Fragment类依然会编译失败。

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