好，我给你做一份 MySQL sql_mode 模式说明及设置的完整教程，帮你彻底弄懂它的作用、常见模式、以及如何设置和持久化。

1. 什么是 sql_mode

sql_mode 是 MySQL 的 SQL 语法和行为控制开关，可以用来限制 SQL 的写法、控制数据校验严格度、以及兼容不同的 SQL 标准。

它主要影响：

  • 语法规则（是否允许非标准 SQL）
  • 数据校验（插入无效值时是报错还是自动转换）
  • 日期和时间格式
  • GROUP BY 行为
  • 兼容性（MySQL vs SQL Server / PostgreSQL 等）

2. 查看当前 sql_mode

-- 会话级（当前连接有效）
SELECT @@SESSION.sql_mode;

-- 全局级（影响新连接）
SELECT @@GLOBAL.sql_mode;

3. 常见 sql_mode 选项说明

模式作用例子
STRICT_TRANS_TABLES严格模式：插入无效值时报错插入超长字符串时直接报错
NO_ZERO_IN_DATE禁止日期中出现零的月/日‘2023-00-05’ 报错
NO_ZERO_DATE禁止 ‘0000-00-00’ 作为日期插入该日期时报错
ERROR_FOR_DIVISION_BY_ZERO除零时报错而不是返回 NULLSELECT 1/0 报错
ONLY_FULL_GROUP_BYGROUP BY 必须包含非聚合列不能 SELECT col1, MAX(col2) GROUP BY col1 之外的列
ANSI_QUOTES让 " 变为标识符引用符SELECT "col" 表示列而不是字符串
TRADITIONAL启用严格的 SQL 行为，组合多种严格模式类似 Oracle/PostgreSQL 严格模式
PAD_CHAR_TO_FULL_LENGTHCHAR 类型字段返回补足空格CHAR(10) 总是返回 10 个字符

4. 设置 sql_mode

（1）会话级设置（仅当前连接有效）

SET SESSION sql_mode = 'STRICT_TRANS_TABLES,NO_ZERO_DATE,ONLY_FULL_GROUP_BY';

（2）全局级设置（影响新连接）

SET GLOBAL sql_mode = 'STRICT_TRANS_TABLES,NO_ZERO_DATE,ONLY_FULL_GROUP_BY';

注意：现有连接不会受影响，需要重新连接。

5. 持久化设置（重启后生效）

MySQL 8.0+（推荐）

编辑配置文件：

  • Linux：/etc/my.cnf 或 /etc/mysql/my.cnf
  • Windows：my.ini

添加：

[mysqld]
sql_mode=STRICT_TRANS_TABLES,NO_ZERO_DATE,ONLY_FULL_GROUP_BY

然后重启 MySQL：

systemctl restart mysqld

6. 查看 MySQL 默认 sql_mode

SHOW VARIABLES LIKE 'sql_mode';

不同版本默认值不同：

  • MySQL 5.7 默认开启 STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,ONLY_FULL_GROUP_BY
  • MySQL 8.0 默认去掉 NO_ZERO_IN_DATE, NO_ZERO_DATE

7. 推荐设置方案

  • 开发环境（宽松，方便调试）：
sql_mode=NO_ENGINE_SUBSTITUTION
  • 生产环境（严格，避免脏数据）：
sql_mode=STRICT_TRANS_TABLES,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION,ONLY_FULL_GROUP_BY