在Android Studio的Kotlin项目中使用Safe Args插件传参报错如何解决

问题根本原因 #

• 你的Fragment类继承的是过时的系统原生android.app.Fragment，而非AndroidX包下的androidx.fragment.app.Fragment，后者才支持requireArguments()方法和Safe Args
• 缺失Fragment KTX扩展导入或依赖，requireArguments()的Kotlin调用需要对应AndroidX扩展支持
• Safe Args的Gradle配置存在遗漏，没有触发参数类的自动生成逻辑
• Android Studio项目缓存过期，IDE未识别到新生成的类和扩展方法

修复步骤 #

步骤1：修正Fragment继承和导入 #

首先确认你的Fragment继承自AndroidX包下的Fragment：

import androidx.fragment.app.Fragment
// 禁止导入import android.app.Fragment

class YourTargetFragment : Fragment() {
    // 类逻辑
}

在文件顶部补全缺失的扩展导入：

import androidx.fragment.app.requireArguments
import androidx.navigation.fragment.navArgs

如果导入标红，在模块级build.gradle的dependencies块添加Fragment KTX依赖：

implementation "androidx.fragment:fragment-ktx:1.6.1"

步骤2：核对Safe Args全链路配置 #

1. 项目根目录build.gradle的plugins块添加插件声明：

id "androidx.navigation.safeargs.kotlin" version "2.5.3" apply false

2. 模块级build.gradle的plugins块应用插件：

id "androidx.navigation.safeargs.kotlin"

3. 确认导航图XML中已经给目标Fragment配置了合法的<argument>标签，参数名称、类型、默认值均符合规范。

步骤3：清理缓存重新构建 #

依次执行以下操作：

• 点击顶部菜单栏 Build -> Clean Project
• 再点击 Build -> Rebuild Project
• 如果仍报错，点击 File -> Invalidate Caches -> 勾选Clear file system cache and local history -> 点击Invalidate and Restart
  等待IDE重启完成索引即可。

步骤4：推荐的参数接收写法 #

无需手动调用requireArguments()，直接用Kotlin委托接收参数即可：

// 在Fragment类内部声明参数变量
private val args: YourTargetFragmentArgs by navArgs()

// 后续直接取值使用
val receivedParam = args.yourParameterName

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