// SQLite 错误参考

SQLITE_SCHEMA:数据库架构已更改

预处理语句在准备之后因模式发生变更而失效,SQLite 无法重新准备它。

结果代码
SQLITE_SCHEMA
名称
17
类别
主要结果代码
错误信息
database schema has changed

它的意思

SQLITE_SCHEMA (17) 表示在语句预处理和执行之间模式发生了变化,比如另一个连接添加了索引或修改了表。用 sqlite3_prepare_v2() (几乎所有现代绑定都会采用的方式)准备的语句会自动重新准备,默认最多重新准备 50 次,所以你只会在使用旧版 sqlite3_prepare() 或重新准备一直失败时。

常见原因

  • 使用旧版 sqlite3_prepare() 接口,在架构更改时不会重新准备。
  • 另一个连接在语句准备和执行期间不断更改模式。
  • 模式变更导致重新准备后的语句失效,例如删除了它用到的列。

如何修复它

  1. 使用以下方式预处理语句 sqlite3_prepare_v2() 或者 sqlite3_prepare_v3() 因此 SQLite 会替你重新准备它们。

  2. 如果这个错误来自语句缓存,请在模式变更后释放缓存的语句并重新准备。

  3. 在应用程序闲置时运行模式迁移,而不是在其他连接执行语句时运行。

相关错误

更多主要结果代码错误

代码和消息文本来自 SQLite 结果和错误代码文档。浏览完整的 SQLite 错误列表 或者 搜索每个数据库错误.

// 错误更少,修复更快

在 SQLly 中使用 SQLite

适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 SQLite 以及你使用的其他数据库。