WordPress不同版本MySQL版本适配要求与兼容问题实操指南

一、WordPress各版本官方适配要求

以下是官方明确的版本适配要求，MariaDB作为MySQL的分支，适配要求整理如下：

版本不符合要求会出现：安装卡住、后台报错、数据乱码、功能异常等问题，按照以下步骤排查解决即可。

二、检查当前环境版本步骤

1. 查看当前WordPress版本

能正常登录后台：进入【仪表盘】-【更新】，页面顶部直接显示当前版本号。

无法登录后台：通过主机文件管理器或FTP打开网站根目录下的wp-includes/version.php文件，查找如下代码即可看到版本：

```
$wp_version = '6.4.3';
```

2. 查看当前MySQL版本

使用面板（宝塔、虚拟主机等）：直接进入数据库管理页面，页面顶部会标注当前MySQL版本，无需额外操作。

使用SSH命令行：登录服务器后输入以下命令即可输出版本：

```
mysql -V
```

三、适配问题实操解决

情况1：MySQL版本低于最低要求，升级操作步骤

所有操作前必须先备份数据库，避免数据丢失，备份命令如下：

```
mysqldump -u你的数据库用户名 -p --all-databases > /root/all_db_backup.sql
```

执行后输入数据库密码即可完成备份，备份文件存在服务器/root目录。

• CentOS7 升级MySQL5.7（推荐版本）步骤：

  ```
  卸载旧版本
  yum remove -y mysql
  rm -rf /var/lib/mysql /etc/my.cnf
  添加官方源
  rpm -Uvh https://dev.mysql.com/get/mysql57-community-release-el7-11.noarch.rpm
  安装
  yum install -y mysql-community-server
  启动并设置开机自启
  systemctl start mysqld
  systemctl enable mysqld
  获取初始密码
  grep 'temporary password' /var/log/mysqld.log
  ```
  

  拿到初始密码后，执行以下命令修改root密码：

  ```
  登录MySQL，输入初始密码
  mysql -u root -p
  修改密码，把「你的新密码」替换成自己的密码
  SET PASSWORD FOR 'root'@'localhost' = PASSWORD('你的新密码');
  FLUSH PRIVILEGES;
  EXIT;
  ```
  

  需要恢复备份执行以下命令即可：

  ```
  mysql -u root -p < /root/all_db_backup.sql
  ```
  

• Ubuntu 升级MySQL5.7，直接执行以下命令即可：

  ```
  sudo apt update
  sudo apt install mysql-server-5.7
  ```
  

• 宝塔面板用户：直接进入软件商店，找到MySQL，点击「设置」-「版本升级」，选择目标版本一键升级即可。

情况2：无法升级MySQL，强制兼容操作步骤

该方案为临时解决方案，仅适用于无法升级的场景，存在一定风险，优先推荐升级到官方要求版本。

操作步骤：

1. 备份网站根目录下的wp-config.php文件到本地
2. 编辑wp-config.php，在 下方添加以下代码，跳过版本检查：

   ```
   // 跳过MySQL版本检查
   add_filter( 'wp_check_mysql_version', '__return_true' );
   ```
   

3. 如果出现字符乱码或者emoji无法显示，修改wp-config.php中的字符集配置：

   原配置一般为：

   ```
   define('DB_CHARSET', 'utf8mb4');
   ```
   

   修改为：

   ```
   define('DB_CHARSET', 'utf8');
   ```