Drift数据库迁移测试中的SQLite双引号字符串陷阱

在开发使用Drift（原Moor）数据库的项目时，数据库迁移是一个常见需求。最近发现了一个在迁移测试中可能遇到的微妙问题，涉及SQLite对双引号字符串的处理方式，值得开发者警惕。

问题现象

在数据库迁移测试中，当尝试查询一个不存在的列时，预期应该抛出SqliteException异常。然而在某些测试环境下，查询却返回了空数组而不是抛出异常。这种不一致行为可能导致迁移逻辑出现漏洞。

根本原因

问题源于SQLite的一个历史遗留特性——双引号字符串。在标准SQL中，双引号用于标识符（如表名、列名），而单引号用于字符串字面量。但SQLite为了兼容性，允许双引号既作为标识符引用，又作为字符串字面量。

当执行类似SELECT "is_default" FROM accounts的查询时：

1. 如果"is_default"列存在，SQLite会将其解析为列引用
2. 如果列不存在，某些SQLite构建版本会将其解释为字符串字面量

影响范围

这个问题主要出现在：

1. 迁移测试场景
2. 使用系统默认SQLite构建的环境
3. 依赖异常处理来检测列是否存在的迁移逻辑

解决方案

1. 显式禁用双引号字符串特性

在创建SchemaVerifier时，通过setup回调明确配置：

verifier = SchemaVerifier(schema.GeneratedHelper(),
    setup: (raw) => raw.config.doubleQuotedStringLiterals = false);

2. 使用更可靠的列检测方法

替代方案是查询SQLite的系统表来检查列是否存在：

final rows = await customSelect(
  'SELECT * FROM pragma_table_info(\'accounts\') WHERE name=\'is_default\';',
  readsFrom: {accounts},
).get();

if (rows.isEmpty) {
  // 执行添加列的操作
}

3. 更新Drift版本

最新版Drift已经默认禁用双引号字符串特性，避免这种意外行为。

最佳实践

1. 避免在迁移逻辑中依赖异常处理
2. 明确测试环境的SQLite配置
3. 优先使用系统表查询方式检测列存在性
4. 保持Drift库版本更新

总结

这个案例展示了数据库迁移中可能遇到的微妙问题，特别是当不同环境使用不同SQLite构建版本时。理解SQLite的这些特性有助于编写更健壮的迁移代码。在Drift项目中，通过适当配置和采用更可靠的检测方法，可以有效避免这类问题。