Skip to main content

MySQL 客户端仅支持 mysql2 包

¥Only the mysql2 package is supported for the MySQL client

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

¥Strapi 5 can only use the mysql2 package for MySQL databases, and the client value for it must be set to mysql.

此页面是 重大变更数据库 的一部分，提供有关重大更改的信息以及从 Strapi v4 迁移到 Strapi 5 的其他说明。

¥This page is part of the breaking changes database and provides information about the breaking change and additional instructions to migrate from Strapi v4 to Strapi 5.

\🔌 此重大更改是否会影响插件？\否
\🤖 此重大更改是否由 codemod 自动处理？\是

重大更改描述​

¥Breaking change description

在 Strapi v4 中

¥In Strapi v4

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

¥The database configuration client option for MySQL databases accepts several values such as mysql and mysql2.

在 Strapi 5 中

¥In Strapi 5

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

¥The database configuration client option for MySQL database only accepts mysql.

迁移​

¥Migration

本节重新组合了有关引入的重大更改的有用说明和程序。

¥This section regroups useful notes and procedures about the introduced breaking change.

注意​

¥Notes

  • Strapi 5 在底层使用 SQLite 数据库的 mysql2 包，并将 mysql 选项重写为 Knex 的 mysql2。

    ¥Strapi 5 uses the mysql2 package for SQLite databases under the hood and rewrites the mysql option as mysql2 for Knex.

  • 有关数据库客户端和配置的更多信息，请参阅 数据库配置 文档。

    ¥Additional information about database clients and configuration can be found in the database configuration documentation.

  • 请同时考虑 MySQL v8 是 Strapi 5 所需的最低版本（请参阅 相关的重大变更条目）。

    ¥Please also consider that MySQL v8 is the minimum required version for Strapi 5 (see the related breaking change entry).

手动程序​

¥Manual procedure

不需要手动迁移，因为 升级工具 的代码修改将处理此更改。

¥No manual migration should be required as codemods from the upgrade tool will handle this change.