Android集成TelemetryDeck因Ktor版本冲突触发NoClassDefFoundError

问题根源 #

TelemetryDeck SDK依赖的Ktor 1.6.7中，io.ktor.client.features.HttpClientFeature类在Ktor 2.0.0中被重构（类路径或API结构发生变化），导致应用运行时找不到该类，抛出NoClassDefFoundError。

可行解决方案 #

• 强制统一Ktor版本（Gradle配置）
  通过Gradle的依赖解析策略，强制所有依赖（包括TelemetryDeck）使用你项目指定的Ktor 2.0.0版本。在模块级的build.gradle（或build.gradle.kts）中添加以下配置：

  configurations.all {
      resolutionStrategy.force "io.ktor:ktor-client-core:2.0.0"
      resolutionStrategy.force "io.ktor:ktor-client-android:2.0.0"
      // 若TelemetryDeck还依赖其他Ktor模块（如ktor-client-json等），需补充对应模块的force规则
  }
  

  注意：这种方式可能存在兼容性风险，如果TelemetryDeck使用了Ktor 1.6.7特有的API，强制升级后可能出现新的报错，需要充分测试。

• 检查TelemetryDeck最新版本
  先确认TelemetryDeck是否已经发布适配Ktor 2.x的版本。如果使用Gradle引入SDK，尝试更新依赖版本号到最新版，再重新构建项目。

• 临时降级项目Ktor版本
  若上述两种方式都无法解决问题，可暂时将项目中的Ktor版本降级至1.6.7，与TelemetryDeck的依赖版本保持一致，待官方发布适配Ktor 2.0.0的SDK版本后再升级。

最坏情况 #

如果强制版本后出现大量API兼容错误，且TelemetryDeck暂无适配计划，那确实需要等待官方发布适配版本，或者向TelemetryDeck团队提交issue反馈该兼容性问题，推动适配进度。

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