Android Studio重命名包后出现NoClassDefFoundError崩溃求助

将Android Studio中应用包名从com.example.travelapp修改为com.company.travelapp后，应用启动即崩溃，触发RuntimeException与NoClassDefFoundError错误，具体为找不到androidx.lifecycle.ReportFragment$ActivityInitializationListener类。完整堆栈信息如下：

java.lang.RuntimeException: Unable to get provider androidx.startup.InitializationProvider: androidx.startup.StartupException: java.lang.NoClassDefFoundError: Failed resolution of: Landroidx/lifecycle/ReportFragment$ActivityInitializationListener;
    at android.app.ActivityThread.installProvider(ActivityThread.java:7642)
    …
    at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:1011)
 Caused by: androidx.startup.StartupException: java.lang.NoClassDefFoundError: Failed resolution of: Landroidx/lifecycle/ReportFragment$ActivityInitializationListener;
    at androidx.startup.AppInitializer.doInitialize(AppInitializer.java:187)
    …
    at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:1011)
 Caused by: java.lang.NoClassDefFoundError: Failed resolution of: Landroidx/lifecycle/ReportFragment$ActivityInitializationListener;
    at androidx.lifecycle.ProcessLifecycleInitializer.create(ProcessLifecycleInitializer.kt:37)
    …
    at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:1011)
 Caused by: java.lang.ClassNotFoundException: Didn't find class "androidx.lifecycle.ReportFragment$ActivityInitializationListener" on path: DexPathList[[zip file "/data/app/~~ohF60lMUCczmAb5rmHzgvw==/com.company.travelapp-g88i1O-Z7OUyKk4cvThJVA==/base.apk"],nativeLibraryDirectories=[/data/app/~~ohF60lMUCczmAb5rmHzgvw==/com.company.travelapp-g88i1O-Z7OUyKk4cvThJVA==/lib/arm64, /system/lib64, /system/system_ext/lib64]]
    at dalvik.system.BaseDexClassLoader.findClass(BaseDexClassLoader.java:207)
    …
    at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:1011)

已尝试的解决步骤 #

• 更新依赖：确保build.gradle中所有lifecycle与startup依赖为最新版本；
• 清理并重建项目：在Android Studio中执行清理和重建操作；
• 检查ProGuard规则：添加规则保留必要类；
• 清除Gradle缓存：移除Gradle缓存以解决可能的损坏问题；
• 手动验证类：尝试在JAR文件中验证该类是否存在。

当前配置信息 #

app级build.gradle配置 #

dependencies {
    implementation 'androidx.lifecycle:lifecycle-runtime:2.4.0'
    implementation 'androidx.lifecycle:lifecycle-process:2.4.0'
    implementation 'androidx.startup:startup-runtime:1.1.0'
}

android {
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
    kotlinOptions {
        jvmTarget = '1.8'
    }
}

ProGuard规则 #

-keep class androidx.lifecycle.** { *; }
-keep class androidx.startup.** { *; }

解决方案 #

1. 确认包名修改完全性 #

• 检查AndroidManifest.xml中所有组件（Activity、Service、Provider等）的android:name属性引用路径是否正确，尤其是系统自动生成的InitializationProvider，避免包名修改导致类路径错误；
• 确认app级build.gradle中的applicationId已更新为com.company.travelapp，与包名保持一致。

2. 升级依赖至兼容版本组合 #

当前lifecycle-process:2.4.0与startup-runtime:1.1.0存在版本兼容隐患，建议同步升级到稳定兼容版本：

implementation 'androidx.lifecycle:lifecycle-runtime:2.6.2'
implementation 'androidx.lifecycle:lifecycle-process:2.6.2'
implementation 'androidx.startup:startup-runtime:1.2.0'

升级后执行File > Sync Project with Gradle Files，再清理重建项目。

3. 禁用自动初始化，改为手动初始化 #

如果自动初始化的InitializationProvider存在问题，可在AndroidManifest.xml中禁用ProcessLifecycleInitializer自动初始化，再手动在Application类中触发：

• 在Manifest中添加配置：

  <provider
      android:name="androidx.startup.InitializationProvider"
      android:authorities="${applicationId}.androidx-startup"
      android:exported="false"
      tools:node="merge">
      <meta-data
          android:name="androidx.lifecycle.ProcessLifecycleInitializer"
          tools:node="remove" />
  </provider>
  

• 自定义Application类并添加初始化代码：

  import androidx.lifecycle.ProcessLifecycleOwner;
  
  public class MyApplication extends Application {
      @Override
      public void onCreate() {
          super.onCreate();
          ProcessLifecycleOwner.get(); // 手动初始化生命周期监听
      }
  }
  

• 在Manifest中指定该Application类：

  <application
      android:name=".MyApplication"
      ...>
  </application>
  

4. 检查多Dex配置 #

若开启了多Dex，需确保以下配置：

• 在app级build.gradle的defaultConfig中添加：

  android {
      defaultConfig {
          ...
          multiDexEnabled true
      }
  }
  

• 针对API level <21的设备，添加多Dex依赖：

  implementation 'androidx.multidex:multidex:2.0.1'
  

  并让Application继承MultiDexApplication，或在attachBaseContext中调用MultiDex.install(this)。

5. 全局验证包名替换 #

使用Android Studio的Edit > Find > Replace in Path功能，全局搜索com.example.travelapp，确保所有位置（类包声明、Manifest组件路径、build.gradle的applicationId、资源文件引用等）都已替换为com.company.travelapp。

内容的提问来源于stack exchange，提问作者James Mbui Gitonga