升级Cloud Firestore 3.4.3后Flutter应用编译失败求助

架构老林

2026-8-23

解决Cloud Firestore 3.4.3构建失败及版本自动回滚问题

强制锁定指定版本
在pubspec.yaml中明确指定cloud_firestore版本，并通过dependency_overrides强制覆盖依赖，避免其他插件间接触发版本升级：
```
dependencies:
  cloud_firestore: 3.3.0

dependency_overrides:
  cloud_firestore: 3.3.0
```
执行flutter pub get，系统会强制安装并锁定3.3.0版本。
清理依赖缓存与锁文件
删除项目根目录下的pubspec.lock文件，再执行flutter clean，最后重新执行flutter pub get。这会彻底清除旧的依赖记录，重新生成匹配指定版本的依赖锁文件。
若仍有问题，可清除Flutter全局缓存：执行flutter pub cache clean后再获取依赖。
检查Firebase依赖兼容性
确保firebase_core、firebase_auth等其他Firebase插件版本与cloud_firestore 3.3.0兼容。可查看pub.dev上cloud_firestore 3.3.0的文档，确认它依赖的firebase_core版本范围，对应调整其他插件版本，避免跨版本冲突。
修复Android端SDK依赖
找不到com.google.firebase.firestore.TransactionOptions通常是Android端Firebase SDK版本不匹配导致的。在android/build.gradle中强制指定兼容的Firebase Firestore SDK版本：
```
buildscript {
  dependencies {
    classpath 'com.google.gms:google-services:4.3.15'
    classpath 'com.google.firebase:firebase-firestore:24.4.0' // 适配cloud_firestore 3.3.0的版本
  }
}
```
同时检查android/app/build.gradle中是否有直接依赖Firebase SDK的代码，确保版本与cloud_firestore对应。
升级Flutter稳定版
若当前Flutter版本较旧，可能与新版本cloud_firestore存在兼容性问题。执行flutter upgrade升级到最新稳定版，再重新安装指定版本的cloud_firestore。