MySQL 客户端仅支持 mysql2 包

页面摘要: Strapi 5 仅支持 mysql2 包用于 MySQL 数据库,并要求将 client 配置选项设置为 mysql。

Strapi 5 只能使用 mysql2 包用于 MySQL 数据库,且其 client 值必须设置为 mysql。

本页面是破坏性变更数据库的一部分,提供有关该破坏性变更的信息,以及从 Strapi v4 迁移到 Strapi 5 的附加说明。

破坏性变更说明

在 Strapi v4 中

MySQL 数据库的数据库配置 client 选项接受多个值,如 mysql 和 mysql2。

在 Strapi 5 中

MySQL 数据库的数据库配置 client 选项只接受 mysql。

迁移

本节汇总了关于该破坏性变更的有用说明和操作步骤。

说明

  • Strapi 5 在底层使用 mysql2 包用于 SQLite 数据库,并将 mysql 选项改写为供 Knex 使用的 mysql2。
  • 有关数据库客户端和配置的更多信息,可在 数据库配置 文档中找到。
  • 另请注意,MySQL v8 是 Strapi 5 所需的最低版本(请参阅 相关破坏性变更条目)。

手动操作步骤

由于 升级工具 中的 codemod 会处理此变更,应无需手动迁移。