GRDB.swift 中关于 eraseDatabaseOnSchemaChange 的注意事项

在 iOS 开发中使用 GRDB.swift 数据库框架时，eraseDatabaseOnSchemaChange 是一个非常有用的调试功能，但开发者需要注意其工作原理以避免意外数据丢失。

功能概述

eraseDatabaseOnSchemaChange 是 GRDB.swift 提供的一个调试选项，当设置为 true 时，会在检测到数据库模式(schema)变更时自动清空数据库。这个功能在开发阶段非常实用，可以避免因模式变更导致的数据不一致问题。

常见问题场景

在实际开发中，开发者可能会遇到这样的情况：即使没有修改任何表结构，数据库仍然在每次应用启动时被清空。这种情况通常是由于表定义中使用了动态默认值导致的。

问题根源分析

问题的核心在于 GRDB.swift 如何判断模式是否发生了变化。框架会对比当前数据库的实际模式与代码定义的模式是否一致。如果发现不一致，就会触发数据清空。

一个典型的错误做法是在表定义中使用动态默认值：

table.column("createdAt", .datetime).notNull().defaults(to: Date())

这种写法会导致每次应用启动时，表定义都会不同（因为 Date() 会生成新的时间戳），从而触发数据库清空。

解决方案

对于时间戳字段，推荐使用以下两种替代方案：

1. 使用 SQLite 内置的 CURRENT_TIMESTAMP：

table.column("createdAt", .datetime).notNull().defaults(sql: "CURRENT_TIMESTAMP")

2. 使用 GRDB.swift 提供的 RecordTimestamps 功能，它提供了更灵活的时间戳管理方式。

最佳实践

1. 在开发环境中启用 eraseDatabaseOnSchemaChange 功能时，确保表定义是静态的
2. 避免在表定义中使用任何会产生动态值的默认值
3. 对于时间戳字段，优先使用 SQLite 内置函数或专门的扩展功能
4. 在生产环境中务必禁用此功能

总结

理解 GRDB.swift 的模式比对机制对于正确使用 eraseDatabaseOnSchemaChange 功能至关重要。开发者应该特别注意表定义的静态性，避免因动态默认值导致意外的数据清空行为。通过采用正确的实践方法，可以充分利用这一调试功能，同时避免不必要的数据丢失。