近日，不少 Android 开发者在将项目目标 SDK 升级至 35 后，遭遇了一个棘手的编译错误：:app:compileDebugJavaWithJavac 失败，错误信息直指 sqflite 插件。这一问题在新建项目或迁移旧项目时频繁出现，严重影响了开发效率。本文将深入剖析错误根源，并提供切实可行的解决方案。

问题现象：一编译就“翻车”

开发者反映，在 Android Studio 中创建新项目，或对现有项目进行依赖更新后，执行编译时控制台输出如下类似错误：

:app:compileDebugJavaWithJavac FAILED
error: cannot find symbol
  symbol:   method getWritableDatabase()
  location: variable database of type Database

错误栈指向 sqflite 内部对 Android SQLite API 的调用。即使在 build.gradle 中明确指定了 compileSdk 35 和 targetSdk 35，问题依然存在。更令人困惑的是，部分开发者在保持 compileSdk 不变的情况下仅升级 targetSdk，也会触发同样的错误。

原因解析：SDK 35 的 API 清理与适配滞后

要理解这个错误，需回溯 Android 14（API 34）和 Android 15（API 35）的 API 变更。Google 在 SDK 35 中加强了对非公开 API 的限制，并清理了一批已废弃的内部方法。其中影响最直接的，是 SQLiteDatabase 的某些内部方法被标记为 @hide 或直接移除，而 sqflite 插件在旧版本中依赖了这些非公开接口。

sqflite 是一个广泛用于 Flutter 和纯 Android 项目的 SQLite 封装库。其早期版本（如 2.x 系列）为了兼容旧设备和提供线程安全操作，通过反射或直接调用 Android 隐藏 API 来获取数据库实例。当 SDK 35 移除这些隐藏方法后，编译工具链在 javac 阶段无法找到符号定义，进而抛出 cannot find symbol 错误。

此外，compileSdk 35 会强制使用 Android 15 的 API 文档进行编译，而 sqflite 的 Java 代码中若未更新对 getWritableDatabase() 等方法的引用，就会导致编译失败。这与 targetSdk 或 minSdk 无关——只要 compileSdk 设为 35，就会触发该问题。

解决方案：升级 sqflite 与调整依赖配置

开发社区已迅速响应，主流解决方案如下：

1. 升级 sqflite 至最新版本

若你使用 Flutter 框架，请在 pubspec.yaml 中将 sqflite 版本更新至 2.4.1 或更高（截至 2025年5月，最新稳定版为 2.5.0+1）。该版本已针对 SDK 35 做了适配，移除了对隐藏 API 的依赖：

dependencies:
  sqflite: ^2.5.0

对纯 Android 项目（非 Flutter），检查 build.gradle 中的 implementation 是否指向了 androidx.sqlite:sqlite:2.4.0+，并确保 sqflite 的 Java 绑定版本同步升级。

2. 临时降级 compileSdk

若项目无法立即升级 sqflite，可暂时将 compileSdk 回退到 34，同时保持 targetSdk 为 35（或更低）。注意，这仅作为短期应急措施，因为 compileSdk 降级会丧失 Android 15 的部分编译时检查能力。

3. 检查 Gradle 插件与 AGP 版本

确保 Android Gradle Plugin（AGP）版本不低于 8.5.0。旧版 AGP 在处理 SDK 35 的 API 映射时可能存在漏洞，导致 javac 误判符号可用性。建议使用 Android Studio Ladybug 2024.3 或更高版本，配合 AGP 8.7+。

4. 手动修复（慎用）

对于无法及时升级依赖的自研项目，可尝试在应用的 Application 类中重写数据库初始化逻辑，绕过 sqflite 的内部调用，直接使用 androidx.sqlite 的公开 API。此方法需要对数据库层有深入理解，且维护成本较高。

预防建议：建立依赖兼容性检查机制

此次事件再次提醒开发者，在升级 SDK 版本前，应充分调研第三方库的适配状态。建议：

  • 提前测试：在非主干分支上先行将 compileSdk 提升至最新，并运行完整编译与回归测试。
  • 关注官方发行注记：每次 Android SDK 更新后，仔细阅读行为变更章节，特别是关于隐藏 API 限制的内容。
  • 使用版本锁定工具：在 gradle.properties 中启用依赖锁文件（dependencyLocking.lockMode=strict），防止因版本冲突导致意外调用。

结语

SDK 35 的编译错误并非孤例，它是 Android 生态持续演进、清理历史技术债务的必然结果。对于开发者而言，保持依赖库的最新状态、理解 API 变更背后的设计哲学，是避免类似问题的根本之道。目前，sqflite 团队已迅速响应并发布修复版本，建议受影响的开发者立即升级，以免阻塞项目开发流程。随着 Android 15 的正式推送，类似兼容性问题预计还会在其他第三方库中出现，提前建立检测与应对机制，将帮助团队减少不必要的技术负债。