升级后网站报错“Unknown system variable 'sql_mode'”

Question

升级后网站报错“Unknown system variable 'sql_mode'”，通常出现在将旧版PHP（如5.6）或老旧CMS（如WordPress 4.x、Discuz! X3.1等）迁移至MySQL 8.0+环境时。根本原因是：MySQL 8.0彻底移除了兼容性变量`sql_mode`的旧式动态设置方式（如通过`SET sql_mode=...`在会话中修改），且默认启用严格SQL模式，而老版本PHP扩展（如mysql_*或早期mysqli）或框架数据库层仍尝试读取/重置该已废弃变量。此外，部分应用在连接初始化时执行`SELECT @@sql_mode`或`SET sql_mode=''`，在MySQL 8.0中触发“Unknown system variable”错误。该问题不反映配置缺失，而是版本不兼容导致的协议级语义变更，需从驱动升级、代码适配或服务端降级兼容模式三方面协同解决。

Answer 1

```html

一、现象层：错误表征与典型复现场景

升级至 MySQL 8.0+ 后，网站前端或后台频繁抛出 Unknown system variable 'sql_mode' 错误，常伴随 PHP Fatal Error 或 WordPress 白屏、Discuz! 数据库连接失败等现象。该错误高频出现在以下组合中：

• PHP 5.6 + mysqli 扩展（未启用 mysqlnd）
• WordPress 4.9.x 及更早版本（含 wp-db.php 中硬编码 SELECT @@sql_mode）
• Discuz! X3.1–X3.2（source/class/db/db_mysql.class.php 初始化逻辑）
• 自研 CMS 使用 mysql_query("SET sql_mode=''") 的遗留代码

二、协议层：MySQL 8.0 的语义断层本质

MySQL 8.0 并非“配置缺失”，而是执行了协议级语义裁剪：

行为	MySQL 5.7 及之前	MySQL 8.0+
SELECT @@sql_mode	返回会话级 sql_mode 值（如 STRICT_TRANS_TABLES,NO_ZERO_DATE）	报错：Unknown system variable 'sql_mode'
SET sql_mode = ''	允许清空（虽不推荐，但兼容）	语法仍有效，但变量已从系统变量列表中移除，部分驱动解析失败

根本原因在于：MySQL 8.0 将 sql_mode 降级为只读会话属性，不再作为可查询的动态系统变量（SHOW VARIABLES LIKE 'sql_mode' 仍可查，但 @@sql_mode 被彻底废弃）。

三、驱动层：PHP 扩展与 mysqlnd 的兼容性分水岭

关键差异在于底层驱动是否支持 MySQL 8.0 的新协议特性：

// ✅ 推荐：使用 mysqlnd 驱动（PHP 7.0+ 默认，且 PHP 5.6 可手动编译启用）
// ❌ 风险：libmysqlclient（旧版 mysqli 或 mysql_* 扩展）无法识别变量废弃逻辑
if (extension_loaded('mysqli')) {
    $driver = mysqli_get_client_info();
    echo "Client: $driver"; // 若输出包含 "mysqlnd" 则具备基础兼容能力
}

mysqlnd 自 5.0.10 起支持 @@ 变量白名单机制，能静默跳过已废弃变量；而 libmysqlclient 在解析 SELECT @@sql_mode 时直接触发协议异常。

四、应用层：CMS 源码级适配路径

以 WordPress 4.9.22 为例，需定位并修改两处核心逻辑：

1. wp-includes/wp-db.php 第 1521 行：注释或替换 $this->get_var("SELECT @@sql_mode");
2. wp-includes/wp-db.php 第 1525 行：将 $this->query("SET sql_mode = '$new_sql_mode'"); 改为条件判断：
   if (version_compare($this->db_version(), '8.0.0', '<')) { ... }

Discuz! X3.1 则需重写 DB::init() 中的初始化 SQL 拦截器，对 MySQL 8.0+ 版本跳过 sql_mode 相关语句。

五、服务层：MySQL 8.0 兼容模式的灰度策略

不推荐长期降级，但可作为迁移过渡手段（需权衡安全与兼容）：

graph LR A[MySQL 8.0 启动] --> B{是否启用兼容模式？} B -->|是| C[my.cnf 添加
sql_mode = ''
skip-grant-tables=false] B -->|否| D[默认 STRICT_TRANS_TABLES 等] C --> E[允许 SELECT @@sql_mode 返回空字符串
（模拟 5.7 行为）] D --> F[强制拒绝所有 @@sql_mode 查询]

注意：此方式仅缓解症状，无法解决严格模式下 INSERT INTO t VALUES(0) 等隐式类型转换失败问题，必须配合应用层校验增强。

六、架构层：面向未来的演进路线图

终极解法是构建数据库抽象契约，而非绑定 MySQL 特定行为：

• 引入 Doctrine DBAL 或 Laravel Query Builder 等现代 ORM，屏蔽底层变量差异
• 在连接池层注入 MySQL 8.0 检测钩子：SELECT VERSION() → 动态禁用 sql_mode 初始化
• 建立跨版本测试矩阵：MySQL 5.7 / 8.0 / 8.4 + PHP 7.4 / 8.1 / 8.3 组合自动化验证

该策略已在 WordPress 6.0+ 和 Discuz! X3.5+ 中落地，体现“语义解耦 > 版本适配”的工程哲学。

```