使用onBackPressedDispatcher时遇UnresolvedReference错误，求解决方案

1. 强制统一Jetpack组件版本 #

出现UnresolvedReference的核心原因大概率是Jetpack组件版本不匹配，activity、fragment、appcompat的版本需要对齐。建议将相关依赖统一到同一稳定版本，比如：

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

同时检查项目依赖树，确认是否有第三方库间接引入了低版本的activity/fragment组件。执行以下命令查看依赖树：

./gradlew app:dependencies

如果发现冲突，在build.gradle(Module level)中添加版本强制规则：

configurations.all {
    resolutionStrategy {
        force "androidx.activity:activity:1.6.1"
        force "androidx.fragment:fragment:1.6.1"
    }
}

2. 确认正确的调用语法 #

在Activity中使用： #

替代原废弃的onBackPressed()方法，直接通过onBackPressedDispatcher注册回调，示例代码：

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    // 注册返回键回调
    onBackPressedDispatcher.addCallback(this) {
        if (needCustomBackHandle()) {
            // 自定义返回逻辑
            finish()
        } else {
            // 交给系统默认处理
            isEnabled = false
            onBackPressedDispatcher.onBackPressed()
            isEnabled = true
        }
    }
}

在Fragment中使用： #

需要通过宿主Activity获取onBackPressedDispatcher，示例代码：

override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    super.onViewCreated(view, savedInstanceState)
    requireActivity().onBackPressedDispatcher.addCallback(viewLifecycleOwner) {
        // Fragment内的自定义返回逻辑
    }
}

3. 清理项目缓存 #

执行以下操作确保缓存不影响依赖解析：

• 点击Android Studio菜单栏 File -> Invalidate Caches... -> Invalidate and Restart
• 执行命令清理构建缓存：

./gradlew clean build

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