Android项目升级Firebase BoM至32.3.1遇firebase-sessions依赖匹配问题

API 探路者

2026-7-10

Firebase BOM升级至32.3.1时依赖版本冲突问题

问题背景

尝试将Android项目中的Firebase库统一升级到32.3.1版本，使用的BOM配置如下：

implementation platform('com.google.firebase:firebase-bom:32.3.1')
implementation 'com.google.firebase:firebase-crashlytics'
implementation 'com.google.firebase:firebase-analytics'
implementation 'com.google.firebase:firebase-config-ktx'
implementation 'com.google.firebase:firebase-perf-ktx'

但升级到32.1.1及以上版本时，出现依赖解析错误：

Could not find any version that matches com.google.firebase:firebase-sessions:[15.0.0, 16.0.0).
Versions that do not match:
  - 1.0.2
  - 1.0.1
  - 1.0.0
Required by:
    project :app > com.google.firebase:firebase-crashlytics:18.4.3
    project :app > com.google.firebase:firebase-perf:20.4.1

实际Maven仓库中firebase-sessions的最新版本仅为1.0.2，与报错中要求的版本范围不匹配。

解决办法

强制指定firebase-sessions版本
在Module级别的build.gradle中添加强制依赖配置，直接指定使用1.0.2版本，覆盖Crashlytics和Performance库的版本要求：
```
configurations.all {
    resolutionStrategy.force 'com.google.firebase:firebase-sessions:1.0.2'
}
```
排查异常依赖干扰
执行以下命令生成完整依赖树，检查是否有第三方或非官方Firebase依赖修改了版本依赖链：
```
./gradlew app:dependencies
```
定位所有引用firebase-sessions的节点，确认是否存在异常依赖。
清理Gradle缓存并重新同步
旧缓存可能导致版本解析异常，执行命令清理缓存后重新同步项目：
```
./gradlew cleanBuildCache
```
确认Google Maven仓库配置
确保Project级别的build.gradle或settings.gradle中正确配置了Google仓库，避免依赖拉取失败：
```
repositories {
    google()
    mavenCentral()
}
```