Android Kotlin项目配置Navigation组件Safe Args插件时出现错误的求助

首先看你遇到的两个核心错误：UnknownPluginException提示找不到Safe Args插件，以及无法加载AndroidComponentsExtension，这通常和Gradle/AGP版本兼容性、插件配置方式有关。下面是具体的修复步骤：

步骤1：修正Project层级的Build Gradle配置 #

Gradle 7.0+推荐使用Plugins DSL替代传统的buildscript块来声明插件，这样能避免很多依赖解析问题。把你的Project级build.gradle改成如下格式：

plugins {
    id 'com.android.application' version '7.1.1' apply false
    id 'org.jetbrains.kotlin.android' version '1.6.10' apply false
    id 'androidx.navigation.safeargs.kotlin' version '2.4.0' apply false
}

task clean(type: Delete) {
    delete rootProject.buildDir
}

如果坚持使用buildscript块，需要确保repositories里包含google()和mavenCentral()，并且classpath配置正确（你的原配置其实这块是对的，但可能因为Gradle版本的加载机制导致问题，所以更推荐上面的新写法）。

步骤2：修复Module层级的Build Gradle配置 #

你的Module级配置有两个问题：重复的Navigation依赖，以及插件声明的冗余项。修改后的配置如下：

plugins {
    id 'com.android.application'
    id 'org.jetbrains.kotlin.android'
    id 'androidx.navigation.safeargs.kotlin'
}

android {
    compileSdk 32
    defaultConfig {
        applicationId "com.project.sunpanel"
        minSdk 23
        targetSdk 32
        versionCode 1
        versionName "1.0"
        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
    kotlinOptions {
        jvmTarget = '1.8'
    }
    buildFeatures {
        viewBinding = true
    }
}

def nav_version = "2.4.0"
dependencies {
    implementation 'androidx.core:core-ktx:1.7.0'
    implementation 'androidx.appcompat:appcompat:1.4.1'
    implementation 'com.google.android.material:material:1.5.0'
    implementation 'androidx.constraintlayout:constraintlayout:2.1.3'
    implementation 'androidx.legacy:legacy-support-v4:1.0.0'
    // 移除重复依赖，只保留版本统一的引用
    implementation("androidx.navigation:navigation-fragment-ktx:$nav_version")
    implementation("androidx.navigation:navigation-ui-ktx:$nav_version")
    
    testImplementation 'junit:junit:4.13.2'
    androidTestImplementation 'androidx.test.ext:junit:1.1.3'
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.4.0'
}

关键修改点： #

1. 移除了重复的Navigation依赖（原配置里既硬编码了2.4.0的依赖，又用变量引用了一次，会导致依赖冲突）
2. 把nav_version的定义移到android块外面，让dependencies块能正确访问
3. 删除了已废弃的kotlin-android-extensions插件（这个插件已经被ViewBinding/DataBinding替代，你已经启用了ViewBinding，不需要再保留它）

步骤3：同步Gradle并清理缓存 #

完成上述修改后：

• 点击Android Studio右上角的Sync Project with Gradle Files按钮同步项目
• 如果还是报错，执行File → Invalidate Caches... → Invalidate and Restart清理缓存并重启AS

额外说明 #

你的AGP版本（7.1.1）和Navigation版本（2.4.0）是兼容的，不用担心版本不匹配的问题；无法加载AndroidComponentsExtension的错误通常是因为Gradle缓存损坏或者依赖解析失败，清理缓存后基本能解决。

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