自托管应用中SQLite数据库迁移实现方式咨询

用户的文件系统中部署有SQLite数据库，当更新应用代码以添加新列、完善关联关系或放宽约束时，是否需要创建由应用在启动时执行的迁移脚本？或是需根据所使用的数据库库编写自动适配的代码？

核心结论 #

两种方案都可行，但迁移脚本是更可靠、易维护的主流方案，自动适配代码仅适合简单场景，扩展性有限。

一、迁移脚本的优势与实践 #

• 可追溯：每一次结构变更都有独立编号的脚本文件（比如001_add_user_email.sql、002_create_order_foreign_key.sql），能清晰追踪数据库版本演进，排查问题时一目了然。
• 可控性：应用启动时先检查已执行的迁移版本，按顺序执行未运行的脚本，确保所有部署实例的数据库结构完全一致，避免环境差异导致的结构混乱。
• 兼容性：能处理复杂变更，比如给新列批量填充历史数据、创建关联索引、修改约束等，还可通过IF NOT EXISTS做幂等处理，避免重复执行报错：

  ALTER TABLE users ADD COLUMN IF NOT EXISTS email TEXT;
  

二、自动适配代码的适用场景 #

仅适合小型原型项目或结构变更极少的简单应用：

• 实现逻辑是启动时对比代码模型与现有数据库结构，自动执行ALTER TABLE等语句。
• 局限明显：无法处理删除列、修改列类型这类复杂变更，容易破坏数据；难以追踪变更历史，出现问题时无法定位根源；不同数据库库的适配逻辑不通用，换库时需重写代码。

三、建议选择 #

如果应用需要长期维护、结构变更频繁或涉及多实例部署，优先采用迁移脚本方案。只有在极小的、结构稳定的项目中，才考虑用自动适配代码简化流程。

内容的提问来源于stack exchange，提问作者Krateng