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

问题背景

在使用SQLDelight进行多模块开发时，开发者遇到了一个典型的多数据库创建问题。项目中包含两个独立模块，每个模块都需要创建自己的数据库。虽然单独创建每个数据库都能成功，但当尝试同时创建两个数据库时，系统仅保留了最后创建的数据库，导致第一个数据库无法正常使用。

问题现象

具体表现为：

1. 当使用不同数据库名称时，只有第二个数据库被成功创建，第一个数据库被覆盖
2. 当尝试使用相同数据库名称时，由于两个数据库版本不同（CoreDb版本2，MusicDb版本1），系统抛出"Can't downgrade database from version 2 to 1"的错误

技术分析

这个问题实际上涉及SQLDelight在Android平台上的数据库驱动实现机制。通过分析可以得出以下关键点：

1. 数据库驱动初始化问题：在Android平台上，SQLDelight通过AndroidSqliteDriver来创建和管理数据库。当多个数据库使用相同的驱动配置时，可能会产生冲突。

2. 数据库名称冲突：虽然开发者尝试使用不同的数据库名称（CORE_DB_NAME和MUSIC_DB_NAME），但在实际实现中可能没有正确传递给驱动层。

3. 依赖注入配置：从Koin模块的初始化代码可以看出，数据库工厂的创建可能存在配置上的问题，导致两个数据库实例无法正确区分。

解决方案

经过深入排查，正确的解决方案应包括以下几个关键步骤：

1. 确保数据库名称唯一性：为每个数据库指定完全不同的名称，避免任何可能的命名冲突。

2. 独立驱动实例：为每个数据库创建完全独立的驱动实例，确保它们之间不会相互干扰。

3. 正确配置依赖注入：在Koin或其他DI框架中，确保每个数据库工厂都能正确获取到自己的配置参数。

4. 版本管理策略：如果确实需要共享数据库文件，需要统一管理数据库版本，确保升级/降级路径明确。

最佳实践建议

1. 模块化数据库设计：对于多模块项目，建议每个业务模块维护自己独立的数据库实例。

2. 命名规范：采用明确的命名约定，如"模块名_db"的形式，避免名称冲突。

3. 配置验证：在应用启动时，可以添加数据库存在性检查，确保所有需要的数据库都已正确初始化。

4. 日志记录：在数据库创建过程中添加详细的日志记录，便于排查类似问题。

总结

SQLDelight作为跨平台的SQLite抽象层，在多数据库场景下需要特别注意配置的隔离性。通过确保每个数据库拥有独立的名称、驱动实例和配置参数，可以避免这类多数据库创建问题。开发者应当仔细检查数据库初始化流程，确保每个环节都正确区分了不同的数据库实例。