SQLDelight多数据库创建问题分析与解决方案

问题背景

在使用SQLDelight进行多模块开发时，开发者遇到了一个典型的多数据库创建问题。项目中包含两个模块，每个模块都需要独立创建自己的数据库。当尝试同时创建两个数据库时，发现只有第二个数据库被成功创建，而第一个数据库则无法正常生成。

问题现象

开发者配置了两个独立的SQLDelight数据库：

1. CoreDb - 版本号为2
2. MusicDb - 版本号为1

当尝试同时初始化这两个数据库时，出现了以下两种情况：

1. 使用不同数据库名称时，只有第二个数据库(MusicDb)被成功创建
2. 使用相同数据库名称时，出现版本降级错误："Can't downgrade database from version 2 to 1"

问题根源分析

经过深入分析，问题的根本原因在于数据库驱动初始化的配置方式。开发者虽然为两个数据库指定了不同的名称，但在实际初始化过程中，数据库驱动可能共享了某些底层资源或配置，导致第一个数据库被第二个覆盖。

解决方案

要解决这个问题，需要确保以下几点：

1. 独立的数据库名称：为每个数据库配置完全不同的名称
2. 独立的驱动实例：确保每个数据库使用完全独立的驱动实例
3. 正确的初始化顺序：避免在初始化过程中出现资源冲突

正确的实现方式应该类似于以下结构：

// 为CoreDb创建独立驱动
val coreDriver = AndroidSqliteDriver(
    schema = CoreDb.Schema,
    context = context,
    name = "CoreDb.db",  // 明确的数据库文件名称
    factory = factory
)

// 为MusicDb创建独立驱动
val musicDriver = AndroidSqliteDriver(
    schema = MusicDb.Schema,
    context = context,
    name = "MusicDb.db",  // 明确的数据库文件名称
    factory = factory
)

最佳实践建议

1. 命名规范：为每个数据库使用清晰且有区分度的名称，建议包含模块前缀
2. 版本管理：确保每个数据库有独立的版本管理策略，避免版本冲突
3. 初始化隔离：在不同模块中隔离数据库初始化过程
4. 资源清理：在使用完毕后，确保正确关闭和清理数据库资源

总结

SQLDelight作为优秀的跨平台数据库解决方案，在多数据库场景下需要特别注意配置隔离。通过确保每个数据库有独立的名称、驱动实例和初始化过程，可以有效避免数据库创建冲突问题。开发者应建立规范的数据库管理策略，特别是在多模块项目中，以保证各个数据库能够独立运行且互不干扰。