AndroidX迁移后抛出ClassNotFoundException：找不到旧版FileProvider

这个问题很常见，核心原因是项目里还有旧的android.support.v4.content.FileProvider引用残留——哪怕你已经替换了自己代码里的引用，下面是几个排查和解决的方向：

1. 检查AndroidManifest.xml中的Provider声明 #

这是最容易忽略的点：你可能在Manifest里还保留着旧的FileProvider类名。打开你的AndroidManifest.xml，搜索FileProvider，如果看到类似这样的代码：

<provider
    android:name="android.support.v4.content.FileProvider"
    android:authorities="${applicationId}.fileprovider"
    android:exported="false"
    android:grantUriPermissions="true">
    <!-- 元数据等内容 -->
</provider>

直接把android:name的值改成androidx.core.content.FileProvider即可。

2. 排查第三方依赖的残留引用 #

有些第三方库可能还在依赖旧的Support库，导致编译时偷偷引入了旧的FileProvider类。你可以通过gradle命令查看完整的依赖树：

• Mac/Linux环境执行：./gradlew app:dependencies
• Windows环境执行：gradlew.bat app:dependencies

在输出结果里搜索com.android.support:support-v4，找到对应的第三方库。解决方式有两种：

• 优先升级该第三方库到支持AndroidX的最新版本
• 如果暂时无法升级，就在依赖声明里手动排除旧的Support库：

  implementation('com.example:problem-library:2.0.0') {
      exclude group: 'com.android.support', module: 'support-v4'
  }
  

3. 确保gradle.properties的AndroidX配置正确 #

打开项目根目录的gradle.properties，确认以下两行配置存在且值为true：

android.useAndroidX=true
android.enableJetifier=true

其中android.enableJetifier=true的作用是自动将第三方库中的Support类引用替换为AndroidX版本，如果这行没开启，旧的引用就不会被自动替换。

4. 清理缓存并重建项目 #

有时候IDE缓存会导致旧的类文件没有被替换，执行以下步骤彻底清理：

• 点击Android Studio顶部菜单栏的Build -> Clean Project
• 接着点击Build -> Rebuild Project
• 极端情况下，可以删除项目根目录的.gradle文件夹和模块下的build文件夹，再重新同步gradle

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