安卓应用启动崩溃的问题排查记录
文章目录
- 场景一
- 启动崩溃的报错信息:Caused by: java.lang.NoClassDefFoundError: Failed resolution of: Lcom/google/android/gms/ads/identifier/AdvertisingIdClient
- 问题排查
- 场景二
- 启动崩溃的报错信息:android.content.res.Resources$NotFoundException: String resource ID #0xffffffff
- 问题排查
- 场景三
- 启动崩溃的报错信息:java.lang.NoClassDefFoundError: Failed resolution of: Landroidx/lifecycle/ReportFragment$ActivityInitializationListener
- 问题排查
场景一
启动崩溃的报错信息:Caused by: java.lang.NoClassDefFoundError: Failed resolution of: Lcom/google/android/gms/ads/identifier/AdvertisingIdClient
--------- beginning of crash
Caused by: java.lang.NoClassDefFoundError: Failed resolution of: Lcom/google/android/gms/ads/identifier/AdvertisingIdClient;
问题排查
问题比较明显,错误信息表明是类加载失败问题,特别是与Google Play服务广告标识符相关的类找不到。
这种问题最常见的原因是两个:
1. 缺少 Google Play 服务依赖
AdvertisingIdClient 属于 play-services-ads-identifier 库。若未在项目中引入该依赖,运行时无法找到该类。
2. 混淆配置错误
若启用代码混淆(ProGuard/R8),未正确保留 AdvertisingIdClient 相关类,导致类被意外移除。
查看构建APK的工程,确实缺少了依赖,添加依赖后可以解决。
dependencies {implementation 'com.google.android.gms:play-services-ads-identifier:18.0.1' // 使用最新稳定版
}
场景二
启动崩溃的报错信息:android.content.res.Resources$NotFoundException: String resource ID #0xffffffff
--------- beginning of crash
05-26 15:15:09.940 E/AndroidRuntime(25589): FATAL EXCEPTION: pool-5-thread-1
05-26 15:15:09.940 E/AndroidRuntime(25589): Process: com.company.demo, PID: 25589
05-26 15:15:09.940 E/AndroidRuntime(25589): android.content.res.Resources$NotFoundException: String resource ID #0xffffffff
05-26 15:15:09.940 E/AndroidRuntime(25589): at android.content.res.Resources.getText(Resources.java:471)
05-26 15:15:09.940 E/AndroidRuntime(25589): at android.content.res.Resources.getString(Resources.java:564)
05-26 15:15:09.940 E/AndroidRuntime(25589): at android.content.Context.getString(Context.java:762)
05-26 15:15:09.940 E/AndroidRuntime(25589): at com.heytap.mcssdk.manage.NotificatonChannelManager$1.run(ProGuard:29)
05-26 15:15:09.940 E/AndroidRuntime(25589): at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1137)
05-26 15:15:09.940 E/AndroidRuntime(25589): at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:637)
05-26 15:15:09.940 E/AndroidRuntime(25589): at java.lang.Thread.run(Thread.java:1012)
问题排查
这个 String resource ID #0xffffffff
肯定是有问题的,0xffffffff 在Android中表示 无效资源ID(十六进制值为 -1),正常的资源ID不会是这个样子。
当代码尝试通过 getString() 或其他资源获取方法传入此值时,系统会抛出 Resources$NotFoundException,因为该ID未关联任何有效字符串资源。
再详细看一下堆栈,除开系统库以外,搞破坏的对象就呼之欲出了。从at com.heytap.mcssdk.manage.NotificatonChannelManager$1.run(ProGuard:29)
去网上查一下,发现这个是OPPO推送SDK的组件库。
回过头来查询我用到的OPPO推送SDK,查了下相关的jar包,确实有调用getString
。再进一步看传入的参数是否无效,最后发现传入的参数取决于下述代码
Class<?> clazz = Class.forName(pkgName + ".R$string");
Field field = clazz.getField("app_name");
return field.getInt(null);
到这里我们基本可以确认,该问题是因为找不到我们应用包名下的app_name
资源。查看apk的话,其实是有这个app_name
的,所以我就在考虑是不是包名出现了什么问题。进一步查看,包名倒也是正常。
回过来重新捋一下,我近期主要的改动是使用了高版本的Unity引擎,导出的android工程结构有所改变。这大概率导致了这个问题的引入。
此时我反编译apk进行搜索R类的资源,发现app_name
确实只出现在com.unity3d.launchers
而没有在我自己的测试包名com.company.demo
。
去看android工程的build.gradle,发现确实是多了一个android.namespace
被配置为了com.unity3d.launchers
,把此处改成我自己的测试包名即可解决问题。
场景三
启动崩溃的报错信息:java.lang.NoClassDefFoundError: Failed resolution of: Landroidx/lifecycle/ReportFragment$ActivityInitializationListener
--------- beginning of crash
07-09 11:16:43.048 E/AndroidRuntime( 960): FATAL EXCEPTION: main
07-09 11:16:43.048 E/AndroidRuntime( 960): Process: com.company.demo, PID: 960
07-09 11:16:43.048 E/AndroidRuntime( 960): java.lang.RuntimeException: Unable to get provider androidx.startup.InitializationProvider: androidx.startup.StartupException: androidx.startup.StartupException: java.lang.NoClassDefFoundError: Failed resolution of: Landroidx/lifecycle/ReportFragment$ActivityInitializationListener;
07-09 11:16:43.048 E/AndroidRuntime( 960): at android.app.ActivityThread.installProvider(ActivityThread.java:7975)
07-09 11:16:43.048 E/AndroidRuntime( 960): at android.app.ActivityThread.installContentProviders(ActivityThread.java:7481)
07-09 11:16:43.048 E/AndroidRuntime( 960): at android.app.ActivityThread.handleBindApplication(ActivityThread.java:7239)
07-09 11:16:43.048 E/AndroidRuntime( 960): at android.app.ActivityThread.-$$Nest$mhandleBindApplication(Unknown Source:0)
07-09 11:16:43.048 E/AndroidRuntime( 960): at android.app.ActivityThread$H.handleMessage(ActivityThread.java:2292)
07-09 11:16:43.048 E/AndroidRuntime( 960): at android.os.Handler.dispatchMessage(Handler.java:106)
07-09 11:16:43.048 E/AndroidRuntime( 960): at android.os.Looper.loopOnce(Looper.java:240)
07-09 11:16:43.048 E/AndroidRuntime( 960): at android.os.Looper.loop(Looper.java:351)
07-09 11:16:43.048 E/AndroidRuntime( 960): at android.app.ActivityThread.main(ActivityThread.java:8423)
07-09 11:16:43.048 E/AndroidRuntime( 960): at java.lang.reflect.Method.invoke(Native Method)
07-09 11:16:43.048 E/AndroidRuntime( 960): at com.android.internal.os.RuntimeInit$MethodAndArgsCaller.run(RuntimeInit.java:584)
07-09 11:16:43.048 E/AndroidRuntime( 960): at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:1013)
问题排查
这个表面看跟场景一就很像。根据提供的错误日志,崩溃原因是 androidx.lifecycle.ReportFragment$ActivityInitializationListener 类未找到(java.lang.NoClassDefFoundError)。但是我看了一下,依赖是正常添加的,我的Demo也没有开混淆。
还是得靠万能的谷歌,搜到两个相关的内容。
(1)https://stackoverflow.com/questions/78503480/after-ranaming-package-in-android-studio-from-com-example-travelapp-to-com-compa
(2)https://issuetracker.google.com/issues/341688001
看起来跟依赖库的版本或者AGP的版本是相关的。尝试升级到更高的AGP版本之后,果然问题解决了。